ReportLab有一个可流动的段落,您可以从reportlab.platypus.Paragraph导入。 在ReportLab包含的所有Flowable中,该段落是最灵活和有用的之一。 您将最有可能在其PLATYPUS框架的任何其他部分中使用它。 该段落可以格式化文本,并允许开发人员使用XML标签更改字体样式和内联颜色。 您也可以使用“段落”来证明您的文本合理,并将其设置为右,左或居中。 最后,您可以使用段落做下标或插入希腊字符。
这是创建Paragraph实例的方法:
p = Paragraph(text, style, bulletText=None)
text参数只是您要在PDF上绘制的字符串。 任何多余的空格将从文本末尾删除。 当您希望使用空格进行格式化时,这可能很烦人,但它确实使在段落中使用Python的三引号文本变得容易。 请注意,在传递字符串时,可以添加一些XML标记来格式化字符串的一部分。
bulletText参数用于为段落的默认项目符号提供文本。 我们将很快讨论更多关于项目符号的信息,但首先让我们看一下段落样式,因为您会更频繁地使用这些样式。
Paragraph类的style参数必须是ParagraphStyle类的实例。 您可以这样导入:
from reportlab.lib.styles import ParagraphStyle
创建ParagraphStyle时,您会注意到,它基本上只是ReportLab称为StyleSheet的段落属性的Python字典。 实际上,您可以通过执行以下操作从ReportLab中获取示例样式表:
from reportlab.lib.styles import getSampleStyleSheet
这允许您做的是创建一个样式表实例,然后可以从中提取ParagraphStyles:
styles = getSampleStyleSheet()
normal_style = styles['Normal']
这只是从ReportLab的示例样式表中获取“普通”样式。 如果要列出所有样式,可以执行以下操作:
代码略
您可以在样式对象上调用list方法以获取所有这些样式的完整列表。 这只是普通样式的设置:
代码略
通过执行以下操作,可以随时从任何样式中获取任何这些设置:
代码略
快速更改样式的属性也很容易。 您需要做的就是:
代码略
请注意,这些更改仅在更改样式时生效,并且仅当您保留对该样式的引用时才生效。 因此,我通常建议仅从其中一种样式进行复制,如果您需要的只是简单的更改,请对其进行修改。
另一方面,如果您想创建自己的ParagraphStyle,则应查看源代码
代码略
有了这些,我们可以轻松地查看新段落样式的默认值。 让我们尝试在Python的解释器中创建自己的段落样式:
代码略
在这里,我们创建一个名为“ Test”的测试样式。 然后,我们检查其默认的Lead属性,结果为12。因此,为了好玩,我们将其设置为14。但是,如何子化ParagraphStyle? 让我们看看:
代码略
该类有点奇怪,但是它基于ParagraphStyle的超类,即PropertySet。 如果您深入研究源代码,会发现它使用Python的魔术来创建类的默认列表,然后调用self .__ dict __。update(self.defaults)来更新类的属性列表。 因此,我们将其复制到子类中。 但是要将前导属性设置为默认属性以外的其他内容,我们需要在更新字典后进行设置。
ReportLab中的段落支持类似XML的标记标签。 您可以使用这些标记来修改段落样式或指定段落内的格式。
下表列出了ReportLab支持的所有最外面的标记标签:
“属性”列列出了我想作为正式标签名称的内容。 “同义词”列也将起作用,您还将注意到,在可能的情况下,ReportLab开发人员将尽可能使用与HTML标准相同的名称。
请注意,您必须将这些标记与<para>标记一起使用。 例如:
代码略
在这里,我们使用本文前面的一些代码创建一个非常简单的演示。 您应该注意的主线是第15行,实际上我们使用<para>标记将文本居中。 如果运行此代码,则最终应该得到一个PDF,该PDF的单行文本位于页面顶部的中心。
使文本居中的更好方法是创建自定义的ParagraphStyle。 这是一个例子:
代码略
在这里,我们仅将ParagraphStyle对象添加到示例StyleSheet中,并将其对齐方式设置为TA_CENTER。
详情参阅 - 亚图跨际