Python ReportLab 使用 splitfirst/splitlast

我正在尝试使用 Python 和 ReportLab 2.2 来创建 PDF 报告。
根据用户指南 http://www.reportlab.com/docs/userguide.pdf,

特殊 TableStyle 索引 [原文如此]

在任何样式命令中，第一行索引可以设置为特殊字符串“splitlast”或“splitfirst”之一，以指示该样式应仅用于拆分表的最后一行或延续的第一行。这允许分割表，并在分割周围产生更好的效果。

我尝试过使用多种样式元素，包括：

('TEXTCOLOR', (0, 'splitfirst'), (1, 'splitfirst'), colors.black) 
('TEXTCOLOR', (0, 'splitfirst'), (1, 0), colors.black) 
('TEXTCOLOR', (0, 'splitfirst'), (1, -1), colors.black) 

这些似乎都不起作用。第一个生成一个 TypeError 并显示以下消息：

TypeError: cannot concatenate 'str' and 'int' objects

后两者会生成 TypeErrors 并显示以下消息：

TypeError: an integer is required

这个功能只是被破坏了还是我做错了什么？如果是后者，我做错了什么？

好吧，看来我要回答我自己的问题了。

首先，文档明确指出“在任何样式命令中，第一行索引可以设置为特殊字符串“splitlast”或“splitfirst”之一，以指示该样式应仅用于最后一行分割表，或延续的第一行。”在当前版本中，“splitlast”和“splitfirst”行索引因前面提到的 TEXTCOLOR 和 BACKGROUND 命令上的 TypeError 而中断。

根据阅读源代码，我怀疑目前只有 tablestyle 行命令（GRID、BOX、LINEABOVE 和 LINEBELOW）与“splitfirst”和“splitlast”行索引兼容。我怀疑所有单元格命令都会因上述类型错误而中断。

但是，我可以通过子类化 Table 类并重写 onSplit 方法来完成我想要的操作。这是我的代码：

class XTable(Table):
    def onSplit(self, T, byRow=1):
        T.setStyle(TableStyle([
          ('TEXTCOLOR', (0, 1), (1, 1), colors.black)]))

其作用是将文本颜色黑色应用于每页第二行的第一个和第二个单元格。 （第一行是标题，由表的 RepeatRows 参数重复。）更准确地说，它对每个框架的第一个和第二个单元格执行此操作，但由于我使用的是 SimpleDocTemplate，因此框架和页面是相同的。