学Python，用Python自动创建PDF文档，实现办公自动化

た入场券 2022-09-05 12:46 459阅读 0赞

我们经常将DOC/DOCX、PPT文档另存或者转换为PDF文档。但是这个转换过程不可控，结果不一定能够达到我们的版式需求，因此本节介绍如何使用库从零开始制作PDF文档。

# 8.2.1　用ReportLab库创建PDF文档 #

ReportLab是一个用于创建PDF文档的Python库，其功能非常强大，安装方法也非常简单，直接用pip命令安装即可。

# 1．创建简单的PDF文档 #

下面我们看一下8.1节示例中的PDF文档是如何自动创建的。

首先从reportlab包的pdfgen目录下导入canvas模块。

>>> from reportlab.pdfgen import canvas

canvas是画布的意思，制作PDF文档好比在空白的画布上作画。

canvas模块有个Canvas类，是创建PDF文档的入口。通过help函数可以查询它的用法。

>>> help(canvas.Canvas)
    ...
    def__init__(self,filename,pagesize=None,bottomup=1,pageCompression=None,invariant=None,verbosity=0, \  
    |encrypt=None,cropMarks=None,pdfVersion=None,enforceColorSpace=None,initialFontName=None, \  
    initialFontSize=None,initialLeading=None,cropBox=None,artBox=None,trimBox=None,bleedBox=None,lang=None,):
    ...

初始化方法可以传入的值很多，必须传入的是待创建的PDF文档的文件名（filename）。

>>> c=canvas.Canvas('H:\示例\第8章\HelloWorld.pdf')
 >>> c
 <reportlab.pdfgen.canvas.Canvas object at 0x00000000025674E0>

方法返回的是  
reportlab.pdfgen.canvas.Canvas类的一个实例对象，赋值给变量c，后面用c指代该实例对象。

用dir函数查看对象的属性和方法，主要包括：absolutePosition、acroForm、addLiteral、addOutlineEntry、addPageLabel、addPostScriptCommand、arc、beginForm、beginPath、beginText、bezier、bookmarkHorizontal、  
bookmarkHorizontalAbsolute、bookmarkPage、bottomup、circle、clipPath、cross、delCatalogEntry、delViewerPreference、doForm、drawAlignedString、drawBoundary、drawCentredString、drawImage、drawInlineImage、drawPath、drawRightString、drawString、drawText、ellipse、endForm、freeTextAnnotation、getAvailableFonts、getCatalogEntry、getCurrentPageContent、getPageNumber、getViewerPreference、getpdfdata、grid、hasForm、highlightAnnotation、imageCaching、init\_graphics\_state、inkAnnotation、inkAnnotation0、line、linearGradient、lines、linkAbsolute、linkRect、linkURL、listLoadedFonts0、pageHasData、pop\_state\_stack、push\_state\_stack、radialGradient、rect、resetTransforms、restoreState、rotate、roundRect、save、saveState、scale、setArtBox、setAuthor、setBleedBox、setCatalogEntry、setCreator、setCropBox、setDash、setDateFormatter、setEncrypt、setFillAlpha、setFillColor、setFillColorCMYK、setFillColorRGB、setFillGray、setFillOverprint、setFont、setFontSize、setKeywords、setLineCap、setLineJoin、setLineWidth、setMiterLimit、setOutlineNames0、setOverprintMask、setPageCallBack、setPageCompression、setPageDuration、setPageRotation、setPageSize、setPageTransition、setProducer、setStrokeAlpha、setStrokeColor、setStrokeColorCMYK、setStrokeColorRGB、setStrokeGray、setStrokeOverprint、setSubject、setTitle、setTrimBox、setViewerPreference、shade、showFullScreen0、showOutline、showPage、skew、state\_stack、stringWidth、textAnnotation、textAnnotation0、transform、translate、wedge。

通过这些方法，我们可以在画布上绘制复杂的PDF文档。

使用setPageSize方法设置页面大小。

>>> c.setPageSize((1200,800))

页面大小也可以在初始化Canvas对象的时候，通过代入.pagesize进行设置。

使用setFont方法设置字体。

>>> c.setFont('Helvetica',200)

设置后，我们可以看到属性值发生了变化。

>>> c._pagesize, c._fontname,c._fontsize
    ((1200, 800), 'Helvetica', 200)

使用drawString方法在画布上书写，参数包括起点坐标和文本内容。PDF文档中的每个元素都和位置相关，所以绘制元素时必须指定坐标。画布上的每个点都可以用坐标（x,y）表示，原点（0,0）在左下角，向右移动增加x值，向上移动增加y值。

>>> c.drawString(50, 400, 'Hello,World!')

画布画完后，使用showPage方法关闭当前页并翻页，继续绘制下一页。

>>> c.showPage()

本例只有一页，直接保存文件，结束任务。

>>> c.save()

用PDF阅读器或者文本编辑器打开PDF文档，可以看到和8.1.1节的PDF文档是一样的。

我们可以解析PDF文档。

>>> import re
    >>> from reportlab.lib.utils import import_zlib as z_pdf
    >>> from reportlab.lib.rl_accel import asciiBase85Decode as abd_pdf
    >>> pdf=open('H:\示例\第8章\HelloWorld.pdf', 'rb').read()
    >>> stream=re.compile(b'.*?FlateDecode.*?stream(.*?)endstream', re.S)
    >>> [z_pdf().decompress(abd_pdf(s.strip(b'\r\n'))) for s in re.findall(stream,pdf)]
     [b'1 0 0 1 0 0 cm  BT /F1 12 Tf 14.4 TL ET\nBT /F1 200 Tf 240 TL ET\nBT 1 0 0 1 50 400 Tm (Hello,World!) Tj T* ET\n \n']

作画之前还可以设置画笔的状态，例如颜色、线条的宽度（\_lineWidth）、写字用的字体（＿fontname、\_fontsize）等。前面我们设置了英文字体，由于reportlab包不带中文字体，需要通过官方渠道下载字体文件（下面用到微软雅黑msyh.ttf），放到reportlab安装包下面的font文件夹中，如图8-5所示。

要注意的是，字体使用之前还需要注册。

>>> from reportlab.pdfbase.ttfonts import TTFont
    >>> from reportlab.pdfbase import pdfmetrics
    >>> pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))

![4b92731528208062ec22572e183fc255.png][]

图8-5

对页面大小的修改在翻页以后仍然有效，但是字体的设置只在本页有效。

>>> c.setPageSize((1200,800))
    >>> c.setFont('Helvetica',200)
    >>> c.showPage()
    >>> c._pagesize, c._fontname,c._fontsize
    ((1200, 800), 'Helvetica', 12)

也就是说，每次翻页，字体都恢复到最初状态。最初的字体状态是由类实例化时传入的数值控制的。

>>> c._initialFontName,c._initialFontSize
    ('Helvetica', 12)

类实例化时调用了init\_graphics\_state方法，初始化了画笔状态，包括字体、颜色、字符间距、线条宽度等。showPage方法调用了\_startPage方法，后者又调用了init\_graphics\_state方法，最终将字体恢复到最初状态（\_initialFontName、\_initialFontSize）。

如果我们需要在同一页面多次设置画笔状态，可以使用saveState和restoreState方法保存和还原画笔状态。

下面以字体设置为例。

>>> c.setFont('Courier',100)
    >>> c.saveState()
    >>> c._pagesize, c._fontname,c._fontsize
    ((1200, 800), 'Courier', 100)
    >>> c.setFont('Helvetica',300)

使用restoreState方法可以将画笔恢复到上次使用saveState方法保存的状态。

>>> c.restoreState()
    >>> c._pagesize, c._fontname,c._fontsize
    ((1200, 800), 'Courier', 100)

**案例：制作精美的封面**

下面我们多次设置画笔状态，书写汉字，并绘制线条和图形。

from reportlab.pdfgen import canvas
       from reportlab.lib.pagesizes import landscape, letter
       from reportlab.pdfbase.ttfonts import TTFont
       from reportlab.pdfbase import pdfmetrics
       from reportlab.lib.colors import pink, black, red, blue, green
    ⓿ pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))
       c=canvas.Canvas(r'H:\示例\第8章\report.pdf')
    ❶ c.setPageSize((1200,800))
       c.drawImage(r'H:\示例\第8章\background.png',0,500,1200,300)
       c.drawImage(r'H:\示例\第8章\logo.png',0,800-72,190,72)
    ❷ c.setFont('微软雅黑',50)
       c.drawCentredString(600, 400,'2020年汽车金融专题研究报告')
       c.setFont('微软雅黑',30)
       c.drawCentredString(600, 300, '南山研究院 分析师 金融哥')
       c.setFont('微软雅黑',20)
       c.drawString(50, 120, '因 / 为 / 专 / 注 / 所 / 以 / 专 / 业')
       c.setFont('微软雅黑',30)
       c.drawRightString(1150, 120, '2020年3月')
    ❸ c.setLineWidth(10)
       c.line(0, 100,1200 ,100 )
       c.setFont('微软雅黑',15)
       c.drawString(50, 80, '本产品保密并受到版权法保护')
       c.drawRightString(1150, 80, 'Confidential and Protected by Copyright Laws')
    ❹ c.setFillColor(red)
       c.rect(800, 500, 1200, 20, stroke=0, fill=1)
    ❺ c.setFillGray(0.75)
       c.setFillAlpha(0.3)
       c.rect(0, 500, 800, 20, stroke=0, fill=1)
       c.showPage()
       c.save()

语句⓿注册中文字体微软雅黑；语句❶设置画布大小；语句❷设置书写要用到的字体；语句❸设置画笔线条宽度；语句❹设置图形填充色；语句❺设置矩形的灰度。还用了drawImage方法添加图片，用rect方法绘制矩形，图片和矩形的参数均要指定起始坐标、宽度和高度，另外图片还要指定文件路径。打开生成的PDF文档，效果如图8-6所示。

![48a65c75afff2382e66aada1c684a638.png][]

图8-6

如果一个PDF文档有多页，每页都有固定的元素，每页都重复绘制的话，代码量就比较大，因此可以将固定部分的制作代码放入循环。

使用Canvas类的doForm、beginForm、endForm方法也可以达到同样的效果。

from reportlab.pdfgen import canvas
       from reportlab.pdfbase.ttfonts import TTFont
       from reportlab.pdfbase import pdfmetrics
       pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))
       c=canvas.Canvas(r'H:\示例\第8章\mydoc_form.pdf')
       c.setPageSize((1200,800))
    ⓿ c.beginForm('LOGO')
       c.drawImage(r'H:\示例\第8章\logo.png',0,800-72,190,72)
    ❶ c.endForm()
       list=['2020年汽车金融专题研究报告','2020年消费金融专题研究报告',         
       '2020年融资租赁专题研究报告','2020年汽车销售专题研究报告']
       for item in list:
    ❷     c.doForm('LOGO')
           c.setFont('微软雅黑',80)
           c.drawCentredString(600, 400,item)
           c.showPage()
       c.save()

语句⓿创建form，并将其命名为LOGO；语句❶结束并保持form；语句⓿和❶之间的代码绘制封面的固定内容，通过循环和语句❷，完成文字的书写。打开生成的PDF文档，效果如图8-7所示。

![f1b5acb407cdad985f242f6c32e07a8c.png][]

图8-7

在以上例子中，我们用drawString、line、rect方法可以书写不同类型的内容。但是这种“画图”的方式非常低端，始终离不开坐标，如果我们要写入一大段文字，则需要计算每一行能放多少字，并不断调整坐标。由于所有的文字都是图画点，也就没有“自动换行”的功能。

pdfgen目录里面的模块还有很多，都只能进行比较底层的操作。如果要制作更复杂的内容，就要用到页面布局（platypus）。

# 2．添加段落、表格与图表 #

要想提升效率，就要减少重复劳动，多用模板和样式。在reportlab包中，platypus目录里的模块就是用来实现各种样式、版式的。platypus是“Page Layout and Typography Using Scripts”的缩写，它致力于把文档的样式和内容分开，段落、表格都直接套用相应的格式，页面也可以套用页面模版。

platypus包括几个层面：文档模板（DocTemplate）、页面模板（PageTemplate）、页面框架（Frame）、页面元素（flowables）。一个文档可以有多个页面模板，一个页面可以有多个框架，一个框架里可以放很多元素。

flowables，即可流动的元素，这是一个形象的比喻。最常见的页面元素就是段落，同样一段文字，随着框架大小的变化，可以被拆分来适应框架，每行字符不固定，其占据的行数也会发生变化。此外，表格、空白（Spacer）、分页符（PageBreak）、图片（Image）都是flowables。图片无法拆分，当框架太小时，它将移动到下一个框架，所以这些元素和坐标系就没有了联系，我们排版布局时，就不用考虑元素的坐标。只需要选择合适的文档和页面模板，设计不同的框架容器，然后依次放入页面元素，即可生成一个PDF文档。

（1）段落

制作段落需要用platypus子目录中paragraph模块的Paragraph类，其语法如下。

Paragraph(text, style, bulletText=None, caseSensitive=1)

它可以将文字和样式生成PDF文档中的段落。

参数text表示各个段落的文本内容。

>>> txt_0='什么是汽车金融？'
    >>> txt_1='''汽车金融是汽车全产业链覆盖的资本流动。狭义的汽车金融隶属于消费金融,广义的汽车金融贯穿全产业链。汽车金融的概念最早源于美国，狭义的汽车金融，更多地关注汽车销售环节，为下游客户提供融资性金融服务,隶属于消费金融。广义的汽车金融，是贯穿汽车的生产、流通、销售、使用、回收等环节中的资金流动，提高资本利用率和资金周转率。'''
    >>> txt_2='''我国汽车消费金融业萌芽于商业银行贷款，后经政策放宽，形成汽车金融公司、汽车融资租赁公司、互联网汽车金融公司等多元主体并存的局面。'''
    >>> txt_3='''中国汽车消费金融渗透率与海外成熟市场差距很大。汽车金融的渗透率，指通过贷款、融资等金融方式购买的车辆数量与汽车销量之比。中国汽车消费金融渗透率一直处于较低水平。'''

参数style表示段落样式。调用lib子目录中styles模块的getSampleStyleSheet函数。

>>> from reportlab.lib.styles import getSampleStyleSheet
 >>> s=getSampleStyleSheet()
 >>> s
 <reportlab.lib.styles.StyleSheet1 object at 0x0000000002BBDDD8>

返回的是样式表StyleSheet1对象，它里面有一些基本的样式可供我们直接使用。用dir函数查看对象的属性和方法，主要包括：add、byAlias、byName、get、has\_key、list。

使用list方法输出全部样式的样式设置。

>>> s.list()

其中，Normal、Title样式的主要默认属性说明见表8-1。

**表8-1**

<table> 
 <tbody> 
 <tr> 
 <td> 属性 </td> 
 <td> 说明 </td> 
 <td> Normal </td> 
 <td> Title </td> 
 </tr> 
 <tr> 
 <td> name </td> 
 <td> 样式名称 </td> 
 <td> Normal </td> 
 <td> Title </td> 
 </tr> 
 <tr> 
 <td> parent </td> 
 <td> 父对象 </td> 
 <td> None </td> 
 <td> &lt;'Normal'&gt; </td> 
 </tr> 
 <tr> 
 <td> alignment </td> 
 <td> 文字对齐 </td> 
 <td> 0 </td> 
 <td> 1 </td> 
 </tr> 
 <tr> 
 <td> allowOrphans </td> 
 <td> 页底段落最小行数 </td> 
 <td> 0 </td> 
 <td> 0 </td> 
 </tr> 
 <tr> 
 <td> allowWidows </td> 
 <td> 页顶段落最小行数 </td> 
 <td> 1 </td> 
 <td> 1 </td> 
 </tr> 
 <tr> 
 <td> backColor </td> 
 <td> 背景颜色 </td> 
 <td> None </td> 
 <td> None </td> 
 </tr> 
 <tr> 
 <td> borderColor </td> 
 <td> 边框颜色 </td> 
 <td> None </td> 
 <td> None </td> 
 </tr> 
 <tr> 
 <td> borderPadding </td> 
 <td> 内容与边距的距离 </td> 
 <td> 0 </td> 
 <td> 0 </td> 
 </tr> 
 <tr> 
 <td> borderRadius </td> 
 <td> 圆角的边框 </td> 
 <td> None </td> 
 <td> None </td> 
 </tr> 
 <tr> 
 <td> borderWidth </td> 
 <td> 边框宽度 </td> 
 <td> 0 </td> 
 <td> 0 </td> 
 </tr> 
 <tr> 
 <td> firstLineIndent </td> 
 <td> 首行缩进 </td> 
 <td> 0 </td> 
 <td> 0 </td> 
 </tr> 
 <tr> 
 <td> fontName </td> 
 <td> 字体名称 </td> 
 <td> Helvetica </td> 
 <td> Helvetica-Bold </td> 
 </tr> 
 <tr> 
 <td> fontSize </td> 
 <td> 字体大小 </td> 
 <td> 10 </td> 
 <td> 18 </td> 
 </tr> 
 <tr> 
 <td> leading </td> 
 <td> 行距 </td> 
 <td> 12 </td> 
 <td> 22 </td> 
 </tr> 
 <tr> 
 <td> leftIndent </td> 
 <td> 左缩进 </td> 
 <td> 0 </td> 
 <td> 0 </td> 
 </tr> 
 <tr> 
 <td> rightIndent </td> 
 <td> 右缩进 </td> 
 <td> 0 </td> 
 <td> 0 </td> 
 </tr> 
 <tr> 
 <td> spaceAfter </td> 
 <td> 段后间隔 </td> 
 <td> 0 </td> 
 <td> 6 </td> 
 </tr> 
 <tr> 
 <td> spaceBefore </td> 
 <td> 段前间隔 </td> 
 <td> 0 </td> 
 <td> 0 </td> 
 </tr> 
 <tr> 
 <td> textColor </td> 
 <td> 文字颜色 </td> 
 <td> Color(0,0,0,1) </td> 
 <td> Color(0,0,0,1) </td> 
 </tr> 
 <tr> 
 <td> wordWrap </td> 
 <td> 单词中换行 </td> 
 <td> None </td> 
 <td> None </td> 
 </tr> 
 </tbody> 
</table>

可以修改样式的默认属性值。

>>> from reportlab.pdfbase.ttfonts import TTFont
    >>> from reportlab.pdfbase import pdfmetrics
    >>> pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))
    >>> s['Title'].fontName,s['Title'].fontSize='微软雅黑' ,30
    >>> s['Title'].spaceAfter,s['Normal'].spaceBefore=30,10
    >>> s['Normal'].fontName,s['Normal'].fontSize='微软雅黑',20
    >>> s['Normal'].leading=30
    >>> s['Normal'].firstLineIndent=40

下面生成段落。

由于platypus子目录中的\_\_init\_\_.py中有语句“from .paragraph import \*”，所以可以直接调用Paragraph类。

>>> from reportlab.platypus import Paragraph

代入文本和样式参数，生成第1个段落对象。

>>> p_0=Paragraph(txt_0,s['Title'])
 >>> type(p_0)
 <class 'reportlab.platypus.paragraph.Paragraph'>
 >>> p_1=Paragraph(txt_1,s['Normal'])
 >>> p_2=Paragraph(txt_2,s['Normal'])
 >>> p_3=Paragraph(txt_3,s['Normal'])

使用platypus目录中doctemplate模块的SimpleDocTemplate类。

>>> from reportlab.platypus import SimpleDocTemplate
 >>> doc=SimpleDocTemplate(r'H:\示例\第8章\mydoc.pdf',pagesize=(1200,800))
 >>> doc
 <reportlab.platypus.doctemplate.SimpleDocTemplate object at 0x0000000004A6DDD8>

使用SimpleDocTemplate对象的build方法，它可以将页面元素放入文档，生成最终的PDF文档。

build(self,flowables,onFirstPage=_doNothing, onLaterPages=_doNothing, canvasmaker=canvas.Canvas)

build方法必要的参数是页面元素，段落就是一种页面元素，但是要将其转为列表，才能作为build方法的参数。

>>> story_text=[p_0,p_1,p_2,p_3]
 >>> type(story_text)
 <class 'list'>

代入参数，生成文件。

>>> doc.build(story_text)

打开生成的PDF文档，效果如图8-8所示。

除了修改样式，我们还可以使用add(style, alias=None)方法添加样式。

>>> from reportlab.lib.styles import ParagraphStyle
 >>> s_par=ParagraphStyle(name='A1',fontName='微软雅黑',fontSize=40,firstLineIndent=0)
 >>> s_par
 <ParagraphStyle 'A1'>
 >>> s.add(s_par)
 >>> p=Paragraph('微软雅黑40号字体',s['A1'])

![329a41d76922ec4c60258a01ab23b537.png][]

图8-8

（2）表格

一般来说，PDF文档中的表格和图表都是通过Excel表格生成，再以图片的形式插入PDF文档中，但是这种图像在放大以后就会变得很模糊，下面尝试直接在PDF文档中绘制表格和图表。

和段落一样，表格也是一种页面元素。

下面需要用platypus子目录中tables模块的Table类制作表格，其语法如下。

Table(data,colWidths=None,rowHeights=None,style=None,repeatRows=0,repeatCols=0,splitByRow=1,emptyTableAction=None,ident=None,hAlign=None,vAlign=None,normalizedData=0,cellStyles=None,rowSplitRange=None, spaceBefore=None,spaceAfter=None,longTableOptimize=None,minRowHeights=None)

数据源data是必须指定的，它是一个二维数组，和要显示的表的每一行、每一列对应。其余的都是可选参数，常用的包括前3个。参数colWidths是一个列表，表示各列的宽度，例如col\_widths=\[100,50, 50\]表示第1列宽100，第2、3列宽50；参数rowHeights表示行高，其设置方法与列宽类似，如果不设置这两个参数，列宽和行高就会变成自适应；参数style表示表格的样式，具体使用TableStyle对象来逐个项目逐个单元格地设置。

首先，构造表格数据参数。

>>> data=[['姓名','一季度','二季度','三季度','四季度'],
    ...['小赵',100,110,125,135], ['小钱',110,114,126,123],
    ...['小孙',120,115,127,141],['小李',130,117,128,165],
    ...['小王',120,127,122,125]]

其次，构造表格列宽、行高参数。

>>> col_widths, row_heights=[80,100,100,100,100],[60,50,50,50,50,50]

然后，构造表格样式参数。调用platypus子目录中Table模块的TableStyle类。

>>> from reportlab.platypus import TableStyle
    >>> from reportlab.lib import colors
    >>> from reportlab.pdfbase.ttfonts import TTFont
    >>> from reportlab.pdfbase import pdfmetrics
    >>> pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))
    >>> table_style=TableStyle([
    ...         ('FONT', (0, 0), (0, -1), '微软雅黑', 30),
    ...         ('FONT', (0, 0), (-1, 0), '微软雅黑', 30),
    ...         ('FONT', (1, 1), (-1, -1), '微软雅黑', 15),
    ...         ('ALIGN', (0, 0), (-1, -1), 'CENTER'),
    ...         ('VALIGN', (0, 0), (-1, -1), 'MIDDLE'),
    ...         ('GRID', (0,0), (-1,-1), 0.5, colors.black),
    ...         ('INNERGRID', (0,0), (-1,-1), 0.25, colors.black),
    ...         ('BOX', (0,0), (-1,-1), 0.25, colors.black),
    ...         ('BACKGROUND',(0,0),(-1,-1),colors.white)])

设置表格样式的语法比较特殊，它使用“属性，左上角，右下角，属性值”，表示对某个单元格区域设置属性。0表示第一行或者第一列，−1表示最后一行或最后一列。例如(0, 0)表示左上角单元格，(−1, −1)表示右下角单元格，围起来的区域就是整个表格。

有了全部参数，下面使用Table类实例化一个表格。

>>> from reportlab.platypus import Table
 >>> 
 table=Table(data,colWidths=col_widths,rowHeights=row_heights,style=table_style)
 >>> type(table)
 <class 'reportlab.platypus.tables.Table'>

给表格增加一个标题。

>>> tabletitle='''<para alignment=center fontName='微软雅黑' fontSize=20 spaceAfter=30>表1： 销售情况表</para>'''
 >>> from reportlab.lib.styles import getSampleStyleSheet
 >>> styles=getSampleStyleSheet()
 >>> from reportlab.platypus import Paragraph

一起放入列表。

>>> story_table=[Paragraph(tabletitle,styles['Normal']),table]

调用SimpleDocTemplate类的build方法，生成PDF文档。

>>> from reportlab.platypus import SimpleDocTemplate
    >>> doc=SimpleDocTemplate(r'H:\示例\第8章\mydoc_table.pdf',pagesize=(1200,800))
    >>> doc.build(story_table)

打开生成的PDF文档，效果如图8-9所示。

（3）图表

在PDF文档中添加各种图形，需要用到graphics子目录中的各个模块。下面尝试直接在PDF文档中绘制图表。

调用shapes模块的Drawing类。

>>> from reportlab.graphics.shapes import Drawing

实例化Drawing类，指定绘图区的宽、高。

>>> d=Drawing(100, 100)
 >>> d
 <reportlab.graphics.shapes.Drawing object at 0x00000000051A2518>

获得一个绘图区Drawing对象，用dir函数查看对象的属性和方法，主要包括：add、asDrawing、asGroup、asString、background、contents、copy、draw、drawOn、dumpProperties、expandUserNodes、getBounds、getContents、getKeepWithNext、getProperties、getSpaceAfter、getSpaceBefore、hAlign、height、identity、insert、isIndexing、minWidth、renderScale、resized、rotate、save、scale、setProperties、shift', 'skew、split、splitOn、transform、translate、vAlign、verify、width、wrap、wrapOn。

![355021d9a4c30e73686da1703b872b7d.png][]

图8-9

有了绘图区，下一步就是绘制条形图。

绘制条形图需要使用barcharts模块中的VerticalBarChart类。

>>> from reportlab.graphics.charts.barcharts import VerticalBarChart
 >>> bar=VerticalBarChart()
 >>> bar
 <reportlab.graphics.charts.barcharts.VerticalBarChart object at 0x00000000051A23C8>

获得一个垂直条形图VerticalBarChart对象，用dir函数查看对象的属性和方法，主要包括：background、barLabelArray、barLabelFormat、barLabels、barSpacing、barWidth、bars、calcBarPositions、categoryAxis、categoryNALabel、data、debug、demo、draw、dumpProperties、fillColor、getBounds、getProperties、getSeriesName、getSeriesOrder、groupSpacing、height、makeBackground、makeBars、makeSwatchSample、naLabel、provideNode、reversePlotOrder、setProperties、strokeColor、strokeWidth、useAbsolute、valueAxis、verify、width、x、y、zIndexOverrides。

下面设置对象的各种属性。

>>> bar.x,bar.y,bar.height,bar.width,bar.valueAxis.valueMin=50,-150,280,500,0
    >>> bar.categoryAxis.categoryNames=['2012','2013','2014','2015','2016']
    >>> bar.data=[[16, 17, 18, 24, 25]]
    >>> bar.bars[0].fillColor,bar.barLabels.nudge=colors.black,18
    >>> bar.barLabelFormat,bar.valueAxis.labels.fontSize='%0.0f',20
    >>> bar.categoryAxis.labels.fontSize,bar.barLabels.fontSize=20,30

通过Drawing对象的add方法将条形图放入绘图区。

>>> d.add(bar)

下面在绘图区中添加一个标题。

>>> from reportlab.graphics.charts.textlabels import Label
    >>> title=Label()
    >>> title.setText('图1： 汽车金融公司数量')
    >>> title.fontSize,title.fontName,title.dx,title.dy=20,'微软雅黑',260,160
    >>> d.add(title)

将绘图区放入列表，为了防止太靠近顶端，在绘图区上方添加空格。

>>> from reportlab.platypus import Spacer
    >>> story_chart=[Spacer(1,75),d]

调用SimpleDocTemplate类的build方法，生成PDF文档。

>>> from reportlab.platypus import SimpleDocTemplate
    >>> doc=SimpleDocTemplate(r'H:\示例\第8章\mydoc_chart.pdf',pagesize=(1200,800))
    >>> doc.build(story_chart)

打开生成的PDF文档，效果如图8-10所示。

![351a6c24030352562dddd37ccd1ce497.png][]

图8-10

本例中的图表是矢量化的图表，即使放大也不会变模糊。

绘图区的保存方式有多种。

>>> from reportlab.pdfgen import canvas
    >>> my_canvas=canvas.Canvas(r'H:\示例\第8章\mydoc_chart.pdf', pagesize=(1200,800))
    >>> d.drawOn(my_canvas, 100, 100)
    >>> my_canvas.save()

或者以下方式。

>>> d.save(formats=['pdf'],fnRoot=r'H:\示例\第8章\mydoc_chart')

或者以下方式。

>>> from reportlab.graphics import renderPDF
    >>> renderPDF.drawToFile(d,r'H:\示例\第8章\mydoc_chart.pdf',autoSize=0)

# 3．页面布局设计 #

单个的段落、表格、图表都容易实现，但有时候我们需要将其混排在一起。前面提到的段落、表格、图表都属于Flowable对象，其位置和坐标没关系，是可以变化的，那么如何才能准确地排版呢？那就需要把它们放置在固定的区域内。使用框架可以将复杂的PDF页面分为不同的区域，用来放置文字、表格、图表等内容。

导入框架类Frame。

>>> from reportlab.platypus import Frame

查看Frame类的帮助信息。

>>> help(Frame)

在帮助文档中可以查到Frame类的实例化参数。

class Frame(builtins.object)
    Frame(x1, y1, width,height, leftPadding=6, bottomPadding=6, rightPadding=6, topPadding=6, id=None, showBoundary=0)

Frame的外观示意图如图8-11所示。

![b9567a3c18ed3b6273c4feb6134d2aa8.png][]

图8-11

Frame主要用于界定了画布上可以放元素的区域。我们看到Frame的左下角的坐标为（x1，y1），该坐标相对于使用时的画布；尺寸为width×height；Padding是指定边距，扣除边距剩下的就是可供绘图的空间；参数id表示识别符；参数showBoundary表示边界线。

下面将页面分为3个区域，分别放入文字、图表、表格。

>>> f1=Frame(0, 0, 600, 400, showBoundary=1, id='f1')
 >>> f2=Frame(600, 0, 600, 400, showBoundary=1, id='f2')
 >>> f3=Frame(0, 400, 1200, 400, showBoundary=1, id='f3')
 >>> f3
 <reportlab.platypus.frames.Frame object at 0x0000000004F86208>

用dir函数查看Frame对象的方法和属性，主要包括：add、addFromList、add\_generated\_content、drawBoundary、id、showBoundary、split。

可以通过设置showBoundary=0不显示框架的线条，这样既可以对齐内容，又不会显得页面太乱，即使是复杂的版式也显得井井有条。

有了框架，我们就再也不用担心画布上的元素无法对齐了。下面创建一个画布。

>>> from reportlab.pdfgen.canvas import Canvas
    >>> c=Canvas(r'H:\示例\第8章\mydoc_Frame.pdf')
    >>> c.setPageSize((1200,800))

使用Frame对象的addFromList(drawlist, canv)方法，可以将元素列表（包含flowables的list）按照框架规定的位置放到画布上面。story\_chart、story\_table、story\_text的制作过程前面已经介绍过，此处不再赘述。

>>> f1.addFromList(story_chart,c)
    >>> f2.addFromList(story_table,c)
    >>> f3.addFromList(story_text,c)
    >>> c.save()

打开生成的PDF文档，效果如图8-12所示。

![e458d4d09c7aa7861ec36ef9cf68ad8e.png][]

图8-12

有时候我们需要在每一页都添加固定的内容，如公司Logo、页码等信息，这时就要用到页眉和页脚。页眉和页脚应当是自动化生成的，在前面调用doForm方法的案例中，我们插入的logo不是页眉，因为下一页的logo还要手动插入，而无法自动生成。

前面我们用到的build方法，还有两个参数onFirstPage和onLaterPages，用于指定在首页的操作和在后面所有页的操作。

我们看一个例子。

from reportlab.platypus import SimpleDocTemplate, Paragraph,PageBreak, Spacer
    from reportlab.lib.styles import getSampleStyleSheet
    from reportlab.pdfbase.ttfonts import TTFont
    from reportlab.pdfbase import pdfmetrics
    pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))
    def header_footer(c, doc):
        c.drawImage(r'H:\示例\第8章\logo.png',1200-190,800-72,190,72)
        c.setFont('微软雅黑',20)
        c.drawString(50, 60, '因 / 为 / 专 / 注 / 所 / 以 / 专 / 业')
        c.setLineWidth(3)
        c.line(0, 50,1200 ,50 )
        c.line(0, 800-75,1200 ,800-75 )
        c.setFont('微软雅黑',20)
        c.drawString(50, 30, '本产品保密并受到版权法保护')
        c.drawRightString(1150, 30, 'Confidential and Protected by Copyright Laws')
        page_num=c.getPageNumber()
        c.setFont('微软雅黑',30)
        text='第 %s页' % page_num
        c.drawRightString(580,20, text)
        c.setFont('微软雅黑',50)
        c.rotate(30)
        c.setFillAlpha(0.2)
        c.drawString(600, 0, '版权所有 南山金融研究')
        c.rotate(-30)
    myPDF=SimpleDocTemplate(r'H:\示例\第8章\mydoc.pdf',pagesize=(1200,800))
    story=[]
    list=['2020年汽车金融专题研究报告','2020年消费金融专题研究报告',         
          '2020年融资租赁专题研究报告','2020年汽车销售专题研究报告']
    styles=getSampleStyleSheet()
    styles['Normal'].fontName='微软雅黑' 
    styles['Normal'].fontSize=40
    for item in list:
        story.append(Spacer(1,200))
        story.append(Paragraph(item, styles['Normal']))
        story.append(PageBreak())
    myPDF.build(story, onFirstPage=header_footer, onLaterPages=header_footer)

函数header\_footer定义了制作页眉和页脚的操作，build方法的参数传入了函数名header\_footer，即onFirstPage=header\_footer、onLaterPages=header\_footer，表示每一页都会自动完成添加页眉和页脚的操作。

打开生成的PDF文档，效果如图8-13所示。

![23da2ed9dc03c785ad3d5fa3c2a64822.png][]

图8-13

本例还实现了在新建文件中添加水印的效果，给已有的文件添加水印，将用其他库来实现。当然，这种水印也很容易去除。还可以将PDF文档的页面转换成图片，然后在图片上加水印，最后将加完水印的图片组合生成PDF文档，这样的水印就难以去除了。

本文截选自《**学Python 不加班 轻松实现办公自动化**》

![04ad4e253e514add2391e8ca25065127.png][]

这是一本关于如何利用Python提高日常办公效率的书，书中凝聚了作者多年的实践经验和独特思考，旨在帮助读者准确、高效地完成大量高重复度的工作。  
  
《学Python，不加班：轻松实现办公自动化》汇集了日常办公和处理文档时常见的问题，通过实例的演示与讲解，帮助读者灵活有效地使用Python处理工作中遇到的问题。全书共11章，涵盖Python的各种应用场景，具体包括文件管理自动化，网络信息自动获取，TXT、XLS／XLSX、DOC／DOCX、PPT、PDF、图片文件的自动化处理，模拟鼠标、键盘操控本地软件，自动化运行管理等。本书力图淡化编程中的抽象概念，贴合工作场景，注重实战效果，通过对Python技术的巧妙讲解，帮助读者成为高效率的办公室“超人”。  
  
《学Python，不加班：轻松实现办公自动化》适合任何想要学习Python编程的读者，尤其适合缺乏编程经验的初学者。同时本书提供所有案例的源代码文件，方便读者边学边练，爱上Python编程。

[4b92731528208062ec22572e183fc255.png]: /images/20220829/2e655a0299e34b5f836fbbaaca649094.png
[48a65c75afff2382e66aada1c684a638.png]: /images/20220829/4c436e82927f43c88eeb7b78a92fd8de.png
[f1b5acb407cdad985f242f6c32e07a8c.png]: /images/20220829/0b4c896a22f64e3ab56751f6b12a72b6.png
[329a41d76922ec4c60258a01ab23b537.png]: /images/20220829/329430b7afae49c2bf5ff8d74ad5424b.png
[355021d9a4c30e73686da1703b872b7d.png]: /images/20220829/cb07d1e9d3a74ef2b1092960be722373.png
[351a6c24030352562dddd37ccd1ce497.png]: /images/20220829/20541a59406e4cdab7b066c8c865dd24.png
[b9567a3c18ed3b6273c4feb6134d2aa8.png]: /images/20220829/3c93112c48ed4f3b839ee3b843d720be.png
[e458d4d09c7aa7861ec36ef9cf68ad8e.png]: /images/20220829/219343ed64aa4f7d9cca321dc4320721.png
[23da2ed9dc03c785ad3d5fa3c2a64822.png]: /images/20220829/5cce67e0945a463380eb3fccb37a373c.png
[04ad4e253e514add2391e8ca25065127.png]: /images/20220829/1c9289279ae842bfbc0e8d729e7ec634.png