我曾经在前面使用WxPython开发跨平台应用程序的时候，写了一篇《WxPython跨平台开发框架之列表数据的通用打印处理》，介绍在WxPython下实现表格数据分页打印处理的过程，在Windows下和MacOS测试效果表现一致。然后在WxPython跨平台的基础上，我利用类似WxPhon的程序框架，使用PySide6/PyQt6实现了另一套跨平台的程序开发，功能上更是比WxPython的实现更加细致和完善了，本篇随笔介绍使用PySide6/PyQt6实现Python跨平台表格数据分页打印预览处理。
1、回顾WxPython的列表数据的通用打印处理
WxPython实现数据的表格预览和打印处理，主要是利用wx.PrintPreview、wx.Printer 和 wx.Printout 等 wxPython 提供的用于打印功能的核心类来处理。
一般列表界面，如下所示。
我们打印模块的处理，需要把这些列表的记录显示在打印预览界面上，并决定是否继续打印即可。
打印预览入口，在列表界面上右键，弹出打印菜单，如下界面所示。
打印预览界面如下所示。
其打印的逻辑，主要就是调用MyPrintOut的自定义对象，然后调用PrintPreview进行打印预览窗体的显示即可。具体的逻辑还是在自定义的 MyPrintout 类里面。
2、使用PySide6/PyQt6实现Python跨平台表格数据分页打印处理
而使用PySide6/PyQt6实现Python跨平台表格数据分页打印预览处理，逻辑上有所不同，这里没有PrintOut对象来处理了。需要根据表格的TableModel对象来进行数据的分页打印。
在开始介绍实现逻辑前，我们先来看看PySide6/PyQt6实现打印预览的效果。
同样我们是在表格展示上给出通用的打印菜单入口，如上图所示，作为答应预览的统一入口。
而由于数据打印的时候，表格列字段可能有些多有些少，因此最好能够根据表格列选择那些可以打印，那些忽略。而选择后，可以进一步选择横向或者竖向等信息，因此在弹出打印预览前，我们让用户确认一下答应的信息，我订做了一个打印预览前的设置对话框，如下所示。
这样我们可以定制打印的相关信息，也方便我们对打印的格式精细化控制。
对于模型数据很多，这需要考虑到分页的处理，我们需要再实现打印预览的时候，实现分页显示的逻辑，分页打印预览的界面如下所示。
了解了PySide/PyQt的打印预览界面后，我们来分析下实现打印的逻辑处理。
打印预览和打印的时候，我们需要考虑显示器和实际打印设备之间的显示尺寸是不同的，有时候显示器设置显示为200%或其他偏大的数据，如果不注意尺寸的调整，很可能打印预览得到的是一个很小区域的显示内容。
在 PySide6 /PyQt6 中，如果你想实现 QTableView 打印功能并确保兼容不同操作系统（如 macOS 和 Windows）的尺寸变化，你可以使用 QPrinter 和 QPrintDialog 来处理打印。要确保尺寸适应变化，你可以根据打印内容自动调整页面布局。
我编写了一个函数，用于计算缩放比例，如下函数所示。
def calculateScale(self, printer: QPrinter, painter: QPainter) -> float:
"""计算每毫米的逻辑单位"""
# 获取打印机的 DPI
ppiPrinterX = printer.resolution()
ppiPrinterY = ppiPrinterX # 假设 X 和 Y 方向的 DPI 相同
# 获取屏幕的 DPI
screen = QApplication.primaryScreen()
ppiScreenX = screen.logicalDotsPerInchX()
ppiScreenY = screen.logicalDotsPerInchY()
# 计算缩放比例，
self.logScale = logScale = float(ppiPrinterX) / float(ppiScreenX)
# 可根据 DPI 比例调整字体大小
print(f"缩放比例: {logScale}")
# 获取页面大小和绘制区域大小
pageRect = printer.pageRect(QPrinter.Unit.DevicePixel) # 页面大小（像素）
paintRect = painter.viewport() # 绘制区域大小（像素）
# 计算缩放比例
scale = logScale * float(paintRect.width()) / float(pageRect.width())
# 设置 QPainter 的缩放比例
painter.scale(scale, scale)
# 计算每毫米的逻辑单位
logUnitsMM = float(ppiPrinterX) / (logScale * 25.4)
print(f"每毫米的逻辑单位: {logUnitsMM}")
return logUnitsMM打印预览的处理，主要就是根据设置对话框，获得横向还是纵向，以及页面大小、标题等信息，然后实现QPreviewDialog里面的paintRequest事件即可，如下预览逻辑处理代码。
def print_preview(self, setting: PrintSetting) -> None:
"""打印预览"""
# print(setting.__dict__)
printer = QPrinter() # QPrinter.PrinterMode.HighResolution
# 打印的处理
printer.setPageSize(setting.page_size)
printer.setPageOrientation(setting.page_orientation)
self.print_cols = setting.print_cols # 打印指定列的索引列表
self.print_title = setting.print_title # 打印标题
self.settings = setting # 保存打印设置
preview_dialog = QPrintPreviewDialog(printer)
preview_dialog.paintRequested.connect(self.print_preview_paint)
preview_dialog.exec()打印预览的处理逻辑，主要就是需要根据缩放的尺寸获得对应的打印区域大小，并根据页面的大小和实现打印的内容显示，计算好尺寸，也就是一般按每页放置多少行，或者每行的高度来计算，如果需要分页，则标识一下即可。
def print_preview_paint(self, printer: QPrinter) -> None:
"""打印预览绘制"""
self.painter = painter = QPainter(printer)
# 计算每毫米的逻辑单位
self.logUnitsMM = self.calculateScale(printer, painter)
# 获取页面大小
# unit 参数的可选值有：
# QPrinter.Unit.Point：点（1 点 = 1/72 英寸）
# QPrinter.Unit.Millimeter：毫米（常用）
# QPrinter.Unit.Inch：英寸
# QPrinter.Unit.Pixel：像素
# 获取页面的可打印区域
page_rect = printer.pageRect(QPrinter.Unit.Millimeter)
self.page_height = page_height = page_rect.height() * self.logUnitsMM
self.page_width = page_width = page_rect.width() * self.logUnitsMM如果内容需要分页才能展示完，那么你要使用printer.newPage()来告诉打印机进行分页。
# 分页打印
print(f"总行数: {total_rows}, 总页数: {total_pages}")
for page in range(total_pages):
if page > 0: # 非第一页，需要换页
printer.newPage()
self.print_page(page, rows_per_page, self.print_cols)
self.painter.end()打印的时候，我们打印列头和每列内容，都是根据实际的列宽进行一定比例的处理，让它能够兼容打印最佳效果。
打印表头的时候，如下代码。
index = 0 # 用来计算递增的列数
for col in range(self.columnCount()):
if print_cols and col not in print_cols:
continue
header_text = self.GetColLabelValue(col)
self.painter.drawText(
int(x_offset + sum(col_widths[:index])), # 累计不同的列宽
y_offset,
header_text,
)
index += 1打印表格每列的内容，处理规则也是类似，如下代码所示
# 绘制表格内容
for row in range(
page * rows_per_page, min((page + 1) * rows_per_page, self.total_rows)
):
y_offset += self.row_height
index = 0 # 用来计算递增的列数
for col in range(self.columnCount()):
if print_cols and col not in print_cols:
continue
# 获取单元格数据
text = self.GetValue(row, col)
# 绘制单元格内容
self.painter.drawText(
int(x_offset + sum(col_widths[:index])), # 累计不同的列宽
y_offset,
text,
)
index += 1其他如标题，横线、页码等信息，根据显示规则绘制即可。