WxPython跨平台开发框架之列表数据的通用打印处理

在WxPython跨平台开发框架中，我们大多数情况下，数据记录通过wx.Grid的数据表格进行展示，其中表格的数据记录的显示和相关处理，通过在基类窗体 BaseListFrame 进行统一的处理，因此对于通例的数据记录打印，我们也可以在其中集成相关的打印处理，本篇随笔介绍怎样使用WxPython内置的打印数据组件实现列表数据的自界说打印处理，以及对记录进行分页等通例操作。
1、WxPython内置的打印数据组件

wx.PrintPreview、wx.Printer 和 wx.Printout 是 wxPython 提供的用于打印功能的核心类。它们帮助开发者在程序中实现打印和打印预览功能。下面是关于这三个类的详细介绍及其使用方法。
1） wx.Printout

wx.Printout 是一个抽象类，通常须要被子类化以便在打印时自界说页面内容。你可以通过继承 wx.Printout 类来实现自界说打印内容，重写 OnPrintPage 方法来决定每一页的打印内容。
常用方法：

• OnPrintPage(page): 该方法是打印过程中每一页的核心方法。你须要在这里绘制要打印的内容，例如文本、图片、图形等。每次页面须要绘制时，该方法会被调用。
  
• GetDC(): 获取一个打印设备上下文（wx.DC 对象），用于在页面上绘制内容。
  
• HasPage(page): 该方法用于检查是否有足够的内容来填充打印页面，返回 True 或 False。
  

简单的wx.PrintOut的子类继承处理如下所示。

1. import wx
3. class MyPrintout(wx.Printout):
4.     def __init__(self):
5.         super().__init__()
7.     def OnPrintPage(self, page):
8.         dc = self.GetDC()
9.         dc.SetFont(wx.Font(10, wx.FONTFAMILY_SWISS, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_NORMAL))
10.         dc.DrawText("Hello, this is a print test!", 100, 100)
11.         return True

复制代码

一样平常情况下，我们肯定会添加很多相关的绘制逻辑处理，这里只是简单的介绍。
2） wx.Printer

wx.Printer 是用来执行实际打印操作的类。它用于与打印机进行交互，发送页面内容到打印机。你可以使用 wx.Printer 来选择打印机、启动打印作业并发送打印内容。
常用方法：

• Print(printout): 用于启动打印操作，将 printout 对象中的内容发送到打印机。
  
• GetCurrentPrinterName(): 获取当前选定的打印机名称。
  
• SetPageSize(width, height): 设置打印页面的大小。
  
• SetPrintData(print_data): 设置打印的数据，控制打印的纸张大小、打印质量等
  

3） wx.PrintPreview

wx.PrintPreview 用于实现打印预览功能，它答应你检察打印内容的预览，而不是直接将内容发送到打印机。通过打印预览，你可以看到打印文档的外观，并进行调整（如分页、内容布局等）。
常用方法：

• IsOk(): 检查打印预览是否成功创建。
  
• Show(): 显示打印预览窗口。
  
• SetPagesPerPreview(pages): 设置每个预览页面显示的页面数。
  

通常，wx.PrintPreview 是在打印机选择之前使用的，它会展示打印内容的预览。预览确认后，用户可以选择继续打印，程序则使用 wx.Printer 实际执行打印操作。
 
绘制二维表的打印预览可以通过在 wx.Printout 类的 OnPrintPage 方法中逐行逐列绘制表格内容。为了实现更复杂的表格布局，通常须要计算每一行和每一列的位置，确保文本不会超出页面界限，并在须要时分页。
如果须要在 wxPython 中实现打印预览，可以使用 wx.PrintPreview 类来生成打印预览。这个类答应你在显示打印预览时，不直接打印内容，而是显示一个打印的“模拟”视图，用户可以在此视图中检察打印效果，决定是否继续打印。
高级功能：表格样式
如果你须要更复杂的表格样式（例如，添加边框、背景致或其他格式化功能），你可以通过 dc.SetPen()、dc.SetBrush() 等方法来实现。
示例：给表格添加边框

1. def draw_table_border(dc, x_pos, y_pos, width, height):
2.     dc.SetPen(wx.Pen(wx.Colour(0, 0, 0)))  # 设置边框颜色
3.     dc.SetBrush(wx.Brush(wx.Colour(255, 255, 255)))  # 设置背景颜色
4.     dc.DrawRectangle(x_pos, y_pos, width, height)

复制代码

你可以在 OnPrintPage 方法中调用此函数，为每个单位格添加边框。
 
2、在框架的基类窗体中实现自界说打印及分页处理

在我的WxPython跨平台开发框架中，我们对于通例窗体列表界面做了抽象处理，一样平常绝大多数的逻辑封装在基类上，基类提供一些可重写的函数给子类实现弹性化的处理。
如下是基类窗体和其他窗体之间的集成关系。

一样平常列表界面，如下所示。

我们打印模块的处理，须要把这些列表的记录显示在打印预览界面上，并决定是否继续打印即可。
前面介绍了wx.PrintOut的子类处理，只是简单的输出一些文本信息，一样平常对于更复杂的打印需求（例如表格或多页文档），你可以在 OnPrintPage 中使用更复杂的绘制逻辑。例如，绘制多个表格行或根据页数拆分内容等等。
我们先来看看实现后的打印预览界面效果，有一个感官熟悉后再继续探寻它的实现机制。
打印预览入口，在列表界面上右键，弹出打印菜单，如下界面所示。

打印预览界面如下所示。

我们来看看，对于列表数据，我们是怎样一步步通过自界说的方式实现打印的内容绘制的。
打印有几个注意的地方，由于不同的操作系统或者不同的设置可能会导致打印面板的尺寸有所差异，因此最好统一转换为一个逻辑的尺寸处理；另外分页的处理是关键，须要根据字体文字计算出你绘制一行所须要的高度，然后根据操作的页面高度计算可以绘制的行数，然后在表格行记录中循环处理，判断达到每页的行数就换行即可。
在我们的WxPython跨平台框架中列表入口菜单的实现如下代码所示，主要就是调用MyPrintOut的自界说对象，然后调用PrintPreview进行打印预览窗体的显示即可，如下代码所示。

1.     def OnPrint(self, event: wx.Event) -> None:
2.         """打印表格"""
4.         # 创建打印数据对象
5.         pageData = wx.PrintData()
6.         pageData.SetPaperId(wx.PAPER_A4)  # 设置纸张类型为 A4
7.         pageData.SetOrientation(wx.LANDSCAPE)  # 设置纸张方向为纵向
9.         # 将打印数据设置到打印机对象
10.         data = wx.PrintDialogData(pageData)
11.         # 窗口标题
12.         page_title = self.GetTitle()
14.         # 创建打印输出对象
15.         printout = ctrl.MyPrintout(self.grid, page_title)
16.         printout2 = ctrl.MyPrintout(self.grid, page_title)
18.         # 创建打印机对象，并将打印数据传递给打印机
19.         # printer = wx.Printer(data)
20.         preview = wx.PrintPreview(printout, printout2, data=data)
21.         if preview.IsOk():
22.             preview.SetZoom(100)
23.             frame = wx.PreviewFrame(
24.                 preview, self, "打印预览", pos=self.GetPosition(), size=self.GetSize()
25.             )
26.             frame.Initialize()
27.             frame.Show(True)

复制代码

wx.PrintPreview须要接受两个PrintOut对象，如代码：printout, printout2
wx.PrintData 主要就是指定页面尺寸及布局等相关信息，具体的逻辑照旧在自界说的 MyPrintout 类里面，它接受当前的wx.Grid对象和当前页面的标题。
而ctrl.MyPrintOut是我们根据须要打印的二维表内容进行的逻辑封装，它们的类初始化代码如下。

1. class MyPrintout(wx.Printout):
2.     """创建一个自定义的 wx.Printout 类，在其中定义如何打印 wx.Grid 的内容。"""
4.     def __init__(
5.         self,
6.         grid: gridlib.Grid,
7.         title: str = "打印标题",
8.         margins=(wx.Point(10, 10), wx.Point(10, 10)),
9.     ):
10.         super().__init__()
11.         self.grid = grid
12.         self.title = title
13.         self.margins = margins
15.         # 获取网格的行列数
16.         self.row_count = self.grid.GetNumberRows()
17.         self.col_count = self.grid.GetNumberCols()
18.         self.current_row = 0  # 记录当前打印的行数

复制代码

我们记录表格对象，以及表格的行数和列数，以及当前打印的行数，默认从0开始，在每次计算分页的时候，须要知道当前的记录才气接着绘制剩余的记录。
我们通过转换逻辑单位，获得绘制设备的页面高度和宽度，然后每行记录的高度，我们根据内容的实际高度+一定的空缺间距，如下代码

1.         font = wx.Font(
2.             FONTSIZE, wx.FONTFAMILY_TELETYPE, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_NORMAL
3.         )
4.         dc.SetFont(font)
5.         # 计算每行的高度
6.         self.lineHeight = dc.GetCharHeight() + 5  # 加上5像素的间距

复制代码

计算每页可以绘制多少行，须要记录摒除标题内容、表格标题行以及相关空缺，剩下的页面高度除以一行的高度，进行计算获得即可。如下代码所示。

1.         # 标题高度 + 标题底部空白行高度 + 表头高度
2.         y_offset = 20 + 20 + 20
3.         # 计算每页可以显示的行数
4.         self.linesPerPage = int((self.pageHeight - y_offset) // self.lineHeight)

复制代码

然后，我们在PrintOut的子类实现中重写 OnPreparePrinting(self) 函数，这个函数在绘制页面前执行一次，我们须要在其中计算出页面的数量。

1.         # 计算页面数
2.         self.numPages = self.row_count // self.linesPerPage
3.         if self.row_count % self.linesPerPage != 0:
4.             self.numPages += 1

复制代码

然后在重写两个函数，决定是否存在下一页，以及页码信息，如下所示的函数实现。

1.     def HasPage(self, page):
2.         return page <= self.numPages
4.     def GetPageInfo(self):
5.         return (1, self.numPages, 1, self.numPages)

复制代码

线条的绘制也是类似，确定位置和颜色等，画线绘制即可。

1.         # 绘制标题，居中显示
2.         text_width, text_height = dc.GetTextExtent(self.title)
3.         title_x = (width - text_width) // 2  # 计算居中的X位置
4.         dc.DrawText(self.title, int(title_x), int(y_offset))

复制代码

绘制表头的时候，我们切换会正常的字体大小，然后遍历绘制

1.         # 设置线条颜色
2.         dc.SetPen(wx.Pen(wx.Colour(0, 0, 0)))  # 黑色线条
3.         # 将所有的坐标转换为整数
4.         dc.DrawLine(line_x, line_y, line_x + line_width, line_y)

复制代码

其中的 col_widths 是我们前面根据表格的列数量进行计算的宽度集合

1.         # 绘制表头
2.         font.SetPointSize(FONTSIZE)
3.         dc.SetFont(font)
4.         for col in range(self.col_count):
5.             dc.DrawText(
6.                 self.grid.GetColLabelValue(col),
7.                 int(x_offset + sum(col_widths[:col])),
8.                 int(y_offset),
9.             )

复制代码

以上内容是我们每页都须要绘制的通例信息，因此先绘制报表表头、线条、表格标题行这些。
下面我们须要根据当前page的页码来计算当前开始的行记录，page为1的时候，那么当前的开始行号是0，否则就是根据页码计算数值。

1. col_widths = [self.grid.GetColSize(col) for col in range(self.col_count)]

复制代码

下面就是对数据进行分页的处理了，如果须要分页，在OnPrintPage函数中返回False，否则返回True，如下代码所示。

1. self.current_row = (page - 1) * self.linesPerPage  # 计算当前页面的起始行数

复制代码

而底部的页码信息，我们简单绘制当前页面和页面总数即可，如下函数。

1.         # 绘制表格的内容
2.         lines_on_page = 0  # 记录当前页面的行数
3.         for row in range(self.current_row, self.row_count):
4.             y_offset += self.lineHeight  # 增加行的高度
5.             for col in range(self.col_count):
6.                 cell_value = self.grid.GetCellValue(row, col)
7.                 dc.DrawText(
8.                     cell_value,
9.                     x_offset + sum(col_widths[:col]),
10.                     y_offset,
11.                 )
12.             lines_on_page += 1
13.             # 如果当前页面的行数已经达到最大值，则绘制页脚，并返回False，继续打印下一页
14.             if lines_on_page >= self.linesPerPage:
15.                 self.draw_footer(dc, page) # 绘制页脚，底部的页码
16.                 return False  # 打印完一页后返回False，继续打印下一页
18.         self.draw_footer(dc, page)
19.         return True

复制代码

最后获得随笔开始前介绍的效果。
如果没有分页信息，那么底部空缺一些，照旧会绘制页码信息，如下是没有更多记录的时候打印预览的界面效果

以上就是整个实现的过程，我们在WxPython开发框架中自界说PrintOut对象，实现WxPython跨平台开发框架之列表数据的通用打印处理过程。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。