我 的 个 人 主 页:👉👉 失心疯的个人主页 👈👈
入 门 教 程 推 荐 :👉👉 Python零基础入门教程合集 👈👈
虚 拟 环 境 搭 建 :👉👉 Python项目虚拟环境(超详细讲解) 👈👈
PyQt5 系 列 教 程:👉👉 Python GUI(PyQt5)文章合集 👈👈
Oracle数据库教程:👉👉 Oracle数据库文章合集 👈👈
优 质 资 源 下 载 :👉👉 资源下载合集 👈👈
优 质 教 程 推 荐:👉👉 Python爬虫从入门到入狱系列 合集👈👈
QtPrintSupport_打印操作
- 前言
- QPaintDevice
- QPagedPaintDevice
- QtPrintSupport
- QAbstractPrintDialog
- QPrintDialog
- QPageSetupDialog
- QPrinter
- QPrintPreviewWidget
- QPrintPreviewDialog
- QPrintEngine
- QPrinterInfo
前言
- 打印图像是图像处理软件中的一个常用功能,打印图像实际上是在
QPaintDevice
中画图,与平时在QWidget
、QPixmap
和QImage
中画图是一样的,都是创建一个QPainter
对象进行画图的 - 只是打印使用的是
QPrinter
,它的本质上也是一个QPaintDevice(绘图设备)
- 打印预览是通过
QtPrintSupport
模块中的QPrintPreviewWidget
或者QPrintPreviewDialog
来实现
QPagedPaintDevice(QPaintDevice) # 支持多个页面的PaintDevice (绘图设备)
QtPrintSupport.py
QPrinter(PyQt5.QtGui.QPagedPaintDevice) # 在打印机上作画的装置
QPrintPreviewWidget(PyQt5.QtWidgets.QWidget) # 用于预览打印机输出的页面布局的小部件
QPrintPreviewDialog(PyQt5.QtWidgets.QDialog) # 用于预览和配置打印机输出的页面布局的对话框
QPageSetupDialog(PyQt5.QtWidgets.QDialog) # 配置对话框,用于打印机上与页面相关的选项
QAbstractPrintDialog(PyQt5.QtWidgets.QDialog) # 用于配置打印机的打印对话框的基本实现
QPrintDialog(QAbstractPrintDialog) # 用于指定打印机配置的对话框
QPrintEngine(sip.simplewrapper) # 定义QPrinter与给定打印子系统交互的接口
QPrinterInfo(sip.simplewrapper) # 提供对现有打印机信息的访问
QPaintDevice
- 描述
- QPaintDevice类是可以用QPainter绘制的对象的基类
- QPaintDevice的绘图功能目前由QWidget、qmage、QPixmap、QGLPixelBuffer、QPicture和QPrinter子类实现
- 为了实现对新后端的支持,您必须从QPaintDevice派生并重新实现虚拟paintenengine)函数,以告诉QPainter应该使用哪个绘制引擎在这个特定的设备上绘制
- 还必须创建一个相应的绘画引擎,以便能够在设备上绘画,即从qpaintenengine派生并重新实现其虚拟功能
- 继承自:qmage, QOpenGLPaintDevice, QPagedPaintDevice, QPaintDeviceWindow, QPicture, QPixmap, QSvgGenerator, QWidget
- 常用API
QPaintDevice 类提供了几个返回各种设备度量的函数 depth() # 返回其位深度(位平面的数量) height() # 以默认坐标系单位(例如QPixmap和QWidget的像素)返回其高度 heightMM() # 以毫米为单位返回设备的高度 width() # 分别以默认坐标系单位返回设备的宽度 widthMM() # 分别以毫米为单位返回设备的宽度 metric() # 通过指定所需的PaintDeviceMetric作为参数来检索度量信息 logicalDpiX() logicalDpiY() # 返回设备的水平和垂直分辨率,单位为每英寸点数 physicalDpiX() physicalDpiY() # 返回设备的分辨率(单位为每英寸点数) # 如果逻辑和物理分辨率不同,相应的qpaintenengine必须处理映射 colorCount() # 函数返回绘制设备可用的不同颜色的数量
QPagedPaintDevice
- 描述
- QPagedPaintDevice 类代表了一个支持多个页面的 PaintDevice (绘图设备)
- 分页绘制设备用于生成打印或PDF等格式的输出
- QPdfWriter 和 QPrinter 继承自它
- 继承自:QPaintDevice
- 常用API
margins() # 返回绘制设备的当前边距。默认值为0,单位是毫米 setMargins(Margins) # 设置要使用的页边距为页边距。 # 边距纯粹是对绘制方法的提示。它们不影响坐标系统或裁剪。 setPageMargins(QMarginsF) → bool # 设置页边距 pageLayout() # 返回当前页面布局 # 使用这个方法可以访问当前的QPageSize、Orientation、QMarginsF、fullRect()和paintRect()。 # 注意:不能在返回的对象上使用setter,您必须调用单独的QPagedPaintDevice.setter或使用setPageLayout() setPageLayout(QPageLayout) → bool # 设置页面布局 pageSize() # 返回当前使用的页面大小 pageSizeMM() # 返回以毫米为单位的页面大小 setPageSize(PageSize) # 设置页面大小为size。 setPageSizeMM(QSizeF) # 设置页面大小为size,尺寸以毫米为单位指定。 # 如果大小与标准PageSize匹配,则使用该页面大小,否则将设置Custom。 setPageOrientation(Orientation) → bool # 设置页面方向
QtPrintSupport
- PyQt为打印提供了广泛的跨平台支持。使用每个平台上的打印系统,PyQt应用程序可以打印到连接的打印机上,也可以通过网络打印到远程打印机上。
- PyQt的打印系统还支持PDF文件生成,为基本报表生成工具提供了基础
- 在PyQt中,打印机由QPrinter表示,QPrinter是一个绘图设备,它提供了特定于打印的功能,例如支持多页和双面输出。因此,打印需要使用QPainter在一系
列页面上进行绘制,就像在自定义小部件或图像上进行绘制一样 - 包含类
QtPrintSupport.py QAbstractPrintDialog(PyQt5.QtWidgets.QDialog) # 用于配置打印机的打印对话框的基本实现 QPrintDialog(QAbstractPrintDialog) # 用于指定打印机配置的对话框 QPageSetupDialog(PyQt5.QtWidgets.QDialog) # 配置对话框,用于打印机上与页面相关的选项 QPrinter(PyQt5.QtGui.QPagedPaintDevice) # 在打印机上作画的装置 QPrintPreviewWidget(PyQt5.QtWidgets.QWidget) # 用于预览打印机输出的页面布局的小部件 QPrintPreviewDialog(PyQt5.QtWidgets.QDialog) # 用于预览和配置打印机输出的页面布局的对话框 QPrintEngine(sip.simplewrapper) # 定义QPrinter与给定打印子系统交互的接口 QPrinterInfo(sip.simplewrapper) # 提供对现有打印机信息的访问
QAbstractPrintDialog
- 描述
- QAbstractPrintDialog类提供了一个基实现,用于配置打印机的打印对话框
- 这个类实现了用于自定义打印对话框中显示的设置getter和setter函数,但它不能直接使用。使用QPrintDialog在你的应用程序中显示打印对话框
- 继承自:QDialog
- 常用API
QAbstractPrintDialog(QPrinter, parent: QWidget = None) # 构造函数 exec() → int exec_() → int # 这个虚函数被调用,弹出对话框。它必须重新实现在子类中 printer() → QPrinter # 返回此打印机对话框所操作的打印机 fromPage() → int # 返回要打印的第一页,默认值为0 toPage() → int # 返回要打印的最后一页,默认值为0 maxPage() → int # 返回打印范围中的最大页 minPage() → int # 返回打印范围中的最小页 printRange() → PrintRange # 返回打印范围 setPrintRange(PrintRange) # 设置打印对话框中的打印范围 setFromTo(m, n) # 设置打印对话框中的范围从m到n setMinMax(int, int) # 将打印对话框中的页范围设置为从最小到最大 # 会启用PrintPageRange选项 setOptionTabs(Iterable[QWidget]) # 如果支持,将小部件列表设置为在打印对话框中显示的选项卡。 # 目前这个选项只在X11上受支持。 # 设置选项卡将把它们的所有权转移到打印对话框 enabledOptions() → PrintDialogOptions setEnabledOptions(Union[PrintDialogOptions, PrintDialogOption]) QAbstractPrintDialog.PrintDialogOption # 用于指定打印对话框的部分应该是可见的 # QAbstractPrintDialog.None # 没有一个选项被启用。 # QAbstractPrintDialog.PrintToFile # 到文件选项打印已启用。 # QAbstractPrintDialog.PrintSelection # 打印选择的选项被启用。 # QAbstractPrintDialog.PrintPageRange # 页面范围选择的选项被启用。 # QAbstractPrintDialog.PrintShowPageSize # 显示页面大小+页边距仅当启用此功能。 # QAbstractPrintDialog.PrintCollateCopies # 启用了分页复印选项 # QAbstractPrintDialog.PrintCurrentPage # 打印当前页面的选项被启用 QAbstractPrintDialog.PrintRange # 用于指定打印范围选择选项 # QAbstractPrintDialog.AllPages # 0 所有网页应打印。 # QAbstractPrintDialog.Selection # 1 唯一的选择应打印。 # QAbstractPrintDialog.PageRange # 2 指定页面范围应打印。 # QAbstractPrintDialog.CurrentPage # 3 只有当前可见的页面应该被打印出来
QPrintDialog
- 描述
- QPrintDialog是一个用于显示打印对话框的类
- 该对话框允许用户更改与文档相关的设置,例如纸张大小和方向、打印类型(彩色或灰度)、页面范围和要打印的副本数量
- 还提供了控件,使用户能够从可用的打印机(包括任何已配置的网络打印机)中进行选择
- 通常,OPrintDialog对象是用OPrinter对象构造的,并使用exec()函数执行
- 继承自:QAbstractPrintDialog
- 常用API
# 构造函数 QPrintDialog(parent: QWidget = None) # 实例化一个打印对话框对象 QPrintDialog(QPrinter, parent: QWidget = None) # 实例化一个打印对话框对象,并关联给定的打印机对象 exec() → int # 显示打印对话框并执行事件循环 exec_() → int # 返回用户点击的按钮:QDialog.Accepted(打印)或QDialog.Rejected(取消) open() # 显示打印对话框并执行事件循环 open(PYQT_SLOT) # 显示打印对话框并执行事件循环 # 打开对话框并将其accept()信号连接到由接收器和成员指定的插槽 # 当对话框关闭时,信号将从插槽断开 printer() # 获取与打印对话框所操作的打印机对象 # 这在使用QPrintDialog.open()方法时非常有用 setPrinter(QPrinter *printer) # 设置与打印对话框关联的打印机对象 options() # 获取打印对话框的选项 testOption(PrintDialogOption) → bool # 检查打印对话框指定的选项是否被启用 setOption(PrintDialogOption option, bool on = true) # 设置打印对话框的选项,影响对话框外观的各种选项 # 如果on为true,则设置给定选项为启用;否则,清除给定的选项 setOptions(Union[PrintDialogOptions, PrintDialogOption]) done(int) # 关闭对话框并将其结果代码设置为result # 如果这个对话框是用exec()显示的,done会导致本地事件循环完成,exec()返回结果
- 可用信号
accepted() accepted(QPrinter) # 当用户接受打印对话框中设置的值时,就会发出这个信号。打印机参数包括应用设置的打印机
QPageSetupDialog
- 描述
- QPageSetupDialog类为打印机上与页面相关的选项提供了一个配置对话框
- 在Windows和macoS上,页面设置对话框是使用本机页面设置对话框实现的。
- 请注意,在Windows和macOS上,自定义纸张大小不会反映在本机页面设置对话框中
- 此外,在QPrinter上设置的自定义页边距不会显示在本机macoS页面设置对话框中
- 继承自:QDialog
- 常用API
# 构造函数
QPageSetupDialog() # 构造一个页面设置对话框
QPageSetupDialog(QWidget *parent = nullptr) # 构造一个页面设置对话框,并设置父控件
QPageSetupDialog(QPrinter *printer, QWidget *parent = nullptr) # 构造一个页面设置对话框,在配置一个默认构造的QPrinter的同时设置父控件
printer() # 获取传递给QPageSetupDialog构造函数的打印机
done(int result)
exec() # 调用这个虚函数来弹出对话框。它必须在子类中重新实现
open(QObject *receiver, const char *member) # 打开对话框并将其accept()信号连接到由接收器和成员指定的插槽
# 当对话框关闭时,信号将从插槽断开
QPrinter
- 描述
- QPrinter类是一个绘图设备,用于在打印机上绘图
- 该设备表示一系列的打印输出页面,其使用方式与其他绘画设备(如:QWidget和QPixmap)几乎完全相同
- 提供了组附加功能来管理特定于设备的特性,例如方向和分辨率,并在生成文档时逐步遍历文档中的页面
- 当直接打印到Windows或macos上的打印机时,OPrinter使用内置的打印机驱动程序
- 在X11上,QPrinter使用通用Unix打印系统(CUPS)将PDF输出发送到打印机。作为一种选择,printProgram(函数可用于指定要使用的命令或实用程序,而不是系统默认值
- 请注意,在无效打印机上设置纸张大小和分辨率等参数是未定义的。你可以用Printer.isValid()在更改任何参数之前验证这一点
- QPrinter支持许多参数,最终用户可以通过打印对话框更改其中的大多数参数。在一般来说,QPrinter将这些函数传递给底层的qprintenengine
- 当QPainter.begin()被调用时,它所操作的QPrinter已经为一个新的页面做好了准备,这使得QPainter可以立即用于绘制文档中的第一页。
- 一旦绘制了第一页,就可以调用newPage(来请求绘制新的空白页,或者调用QPainter.end()来完成打印。
- 在绘制第二页和后面的所有页面之前,使用对newPage()的调用来准备它们
- 文档中的第一页不需要先调用newPage()。只有在需要在打印文档的开头插入空白页时,才需要在QPainter.begin()之后调用newPage()
- 类似地,在绘制文档中的最后一页后调用newPage()将导致在打印文档的末尾追加一个空白页
- 如果要中止打印作业,abort()将尽力停止打印。它可能会取消整个作业或只是部分作业
- 由于QPrinter可以打印到任何QPrintEngine的子类,因此可以通过创建OPrintEngine的子类并重新实现其接口来扩展打印支持,以覆盖新的打印子系统类型
- 继承自:QPagedPaintDevice
- 枚举类型
# 打印颜色 QPrinter.ColorMode QPrinter.Color # 1 如果可用,以彩色打印,否则以灰度打印 QPrinter.GrayScale # 0 以灰度打印,即使在彩色打印机上也是如此 # 单双面打印 QPrinter.DuplexMode QPrinter.DuplexNone # 0 单面打印 QPrinter.DuplexAuto # 1 打印机的默认设置,用于确定是否使用双面打印 QPrinter.DuplexLongSide # 2 双面打印,长边翻转 QPrinter.DuplexShortSide # 3 双面打印,短边翻转 # 打印方向 # 此枚举类型(不要与Orientation混淆)用于指定每个页面的方向 QPrinter.Orientation QPrinter.Portrait # 0 纵向,页面的高度大于宽度 QPrinter.Landscape # 1 横向,页面的宽度大于高度 # 打印格式 QPrinter.OutputFormat QPrinter.NativeFormat # 0 QPrinter将使用它运行的平台定义的方法打印输出。当直接打印到打印机时,此模式是默认的 QPrinter.PdfFormat # 1 QPrinter将生成一个可搜索的PDF文件。当打印到文件时,此模式是默认的 # 打印顺序 QPrinter.PageOrder QPrinter.FirstPageFirst # 0 编号最低的那一页优先打印 QPrinter.LastPageFirst # 1 编号最高的那一页优先打印 # 纸张大小 # QPrinter不检查纸张尺寸是否可用;它只是使用这些信息 # 连同QPrinter.Orientation 和QPrinter.setFullPage(),来确定可打印的区域 QPrinter.PaperSize # 标准Postscript和Windows Executive大小 QPageSize.ExecutiveStandard # 标准Postscript和Windows DMPAPER_FOLIO大小 QPageSize.FanFoldGermanLegal QPageSize.PageSizeId.A0 ... QPageSize.PageSizeId.LastPageSize # Letter、Legal、Folio、Executive是纸张尺寸的意思 # 应用于加拿大、美国和墨西哥等国家 # 各自的尺寸: # Letter 216毫米x279毫米 # Legal 216毫米×356毫米 # Folio 216毫米×330毫米 # Executive 184毫米x267毫米 # 纸张大小还可以使用QPagedPaintDevice枚举 QPagedPaintDevice.A0 ... QPagedPaintDevice.LastPageSize # 纸张来源(仅Windows有效) # 是否会设置纸张来源取决于打印机是否具有该特定来源 QPrinter.PaperSource QPrinter::Auto ... QPrinter.LastPaperSource # 打印范围 QPrinter.PrintRange QPrinter.AllPages # 0 打印所有页面 QPrinter.Selection # 1 打印选定内容 QPrinter.PageRange # 2 打印指定的页面范围 QPrinter.CurrentPage # 3 只打印当前页面 # 打印模式(分辨率) QPrinter.PrinterMode QPrinter.ScreenResolution # 0 将打印设备的分辨率设置为屏幕分辨率 QPrinter.PrinterResolution # 1 此值已弃用 QPrinter.HighResolution # 2 将打印机分辨率设置为为正在使用的打印机定义的分辨率 # 打印设备状态 QPrinter.PrinterState QPrinter.Idle # 0 空闲 QPrinter.Active # 1 活跃的 QPrinter.Aborted # 2 异常中止连接 QPrinter.Error # 3 错误 # 指定页面和纸张大小的测量单位 QPrinter.Unit QPrinter.Millimeter # 0 毫米 QPrinter.Point # 1 单位被定义为1/72英寸 QPrinter.Inch # 2 英寸 QPrinter.Pica # 3 QPrinter.Didot # 4 QPrinter.Cicero # 5 QPrinter.DevicePixel # 6 单位与分辨率有关,并基于打印机上的实际像素或点
- 常用API
# 构造函数 # 实例化打印机对象 QPrinter() # 实例化打印机对象,并指定打印机信息和打印模式 QPrinter(const QPrinterInfo &printer, QPrinter.PrinterMode mode = ScreenResolution) # 实例化打印机对象,并指定模式 QPrinter(QPrinter.PrinterMode mode = ScreenResolution) abort() # 中止当前的打印运行 # 如果打印运行被成功中止,则返回true, PrinterState()将返回QPrinter.aborted; # 如果打印运行中止失败,则返回false # 并非总是可以中止打印作业。例如,所有数据都已发送到打印机,但打印机不能或不会在被要求取消作业时取消该作业 collateCopies() # 返回是否启用选择多个副本 colorMode() # 返回当前颜色模式 copyCount() # 返回要打印的拷贝数。缺省值为1 creator() # 返回创建文档的应用程序的名称 docName() # 返回文档名称 duplex() # 返回当前双工模式 fontEmbeddingEnabled() # 如果启用了字体嵌入,则返回true fromPage() # 返回要打印的页面范围中第一页的页码 # 默认情况下,返回0,表示“from page”设置未设置 fullPage() # 返回打印机坐标系统的原点是否在页面的角上 isValid() # 返回当前选择的打印机是否有效,或者是纯PDF打印机 newPage() # 弹出当前页面并在新页面上继续打印。如果成功返回true;否则返回false # 在非活动QPrinter对象上调用newPage()总是会失败 outputFileName() # 返回输出文件的名称。默认是空字符串(表示打印机不应该打印到file) outputFormat() # 返回此打印机的输出格式 pageLayout() # 返回当前页面布局 pageOrder() # 返回当前页面顺序 pageRect(QPrinter.Unit) # 以指定单位返回打印区域大小 paperRect(QPrinter.Unit) # 以指定单位返回纸张的大小 paperSource() # 返回打印机的纸张源(手动或托盘或纸盒) pdfVersion() # 返回此打印机的PDF版本。默认为PdfVersion_1_4 printEngine() # 返回打印机使用的打印引擎 printProgram() # 返回将打印输出发送到打印机的程序的名称 printRange() # 返回QPrinter的页面范围。打开打印设置对话框后,该函数返回用户选择的值 printerName() # 返回打印机名称。该值最初设置为默认打印机的名称 printerSelectionOption() # 返回打印机选项选择字符串,默认返回空字符串,意味着以与系统相关的方式选择打印机 printerState() # 返回打印机的当前状态。这可能并不总是准确的 resolution() # 返回当前假定的打印机分辨率,由setResolution()或打印机驱动程序设置 supportedPaperSources() # 返回此打印机支持的纸张大小。仅在windows中可用 supportedResolutions() # 返回打印机表示支持的分辨率列表(每英寸点整数列表) supportsMultipleCopies() # 打印机是否支持在一个作业中打印同一文档的多个副本 toPage() # 返回要打印的页面范围中最后一页的页码 PaintEngine() setOrientation() # 设置页面方向 setPaperSize() # 设置纸张大小 setResolution(int dpi) # 设置分辨率,单位是每英寸点(DPI)。 setFullPage(bool fp) # 如果fp为true,则支持在整个页面上绘制;否则将绘画限制在设备报告的可打印区域。 setCopyCount(int count) # 设置打印份数 setEngines(QPrintEngine *printEngine, QPaintEngine *paintEngine) # QPrinter的子类使用这个函数来指定自定义打印和绘制引擎(分别是printenengine和paintenengine) setCollateCopies(bool collate) # 设置出现打印对话框时排序复选框的默认值 setColorMode(QPrinter.ColorMode newColorMode) # 设置打印机的颜色模式 setCreator(const QString &creator) # 设置创建文档的应用程序的名称 setDocName(const QString &name) # 设置文档名称,文档名称不会影响文件名 setDuplex(QPrinter.DuplexMode duplex) # 启用基于双面模式的双面打印 setFontEmbeddingEnabled(bool enable) # 是否启用字体嵌入 setFromTo(int from, int to) # 设置要打印的页面范围,由from和to指定编号的页面 # from和to都设置为0,则将打印整个文档 setOutputFileName(const QString &fileName) # 设置输出文件的名称 # 文件名称设置为null或空名称(0或"")将禁用打印到文件。设置非空名称可以打印到文件 setOutputFormat(QPrinter.OutputFormat format) # 设置此打印机要格式化的输出格式 setPageLayout(const QPageLayout &newLayout) # 设置页面布局 setPageMargins(const QMarginsF &margins) # 使用当前单位设置页边距为页边距。如果成功设置页边距,则返回true setPageMargins(const QMarginsF &margins, QPageLayout.Unit units) # 设置页边距为给定单位的页边距。如果没有提供单位,则使用当前单位 setPageOrder(QPrinter.PageOrder pageOrder) # 设置页面打印顺序 setPageOrientation(QPageLayout.Orientation orientation) # 设置页面方向为纵向或横向 setPageSize(const QPageSize &pageSize) # 设置页面大小 setPaperSource(QPrinter.PaperSource source) # 设置纸张源 setPdfVersion(QPagedPaintDevice.PdfVersion version) # 设置打印机的PDF版本 setPrintProgram(const QString &printProg) # 设置将应该执行打印作业的程序的名称 setPrintRange(QPrinter.PrintRange range) # 设置打印范围选项 setPrinterName(const QString &name) # 设置打印机名称 # 如果名称为空,则输出格式将设置为PdfFormat。 # 如果名称不是有效的打印机,则不会进行更改。 # 如果名称是有效的打印机,则输出格式将设置为NativeFormat setPrinterSelectionOption(const QString &option) # 设置打印机使用选项来选择打印机 setMargins(const QPagedPaintDevice.Margins &m)
QPrintPreviewWidget
- 描述
- QPrintPreviewWidget类提供了一个小部件,用于预览打印机输出的页面布局
- QPrintPreviewDialog在内部使用QPrintPreviewWidget,QPrintPreviewWidget的目的是使预览嵌入到其他小部件中成为可能。
- 它还使得围绕它构建一个不同于QPrintPreviewDialog提供的默认用户界面的用户界面成为可能
- 继承自:QWidget
- 枚举
# 描述预览小部件的视图模式 QPrintPreviewWidget.ViewMode QPrintPreviewWidget.SinglePageView # 0 查看预览中的单个页面的模式 QPrintPreviewWidget.FacingPagesView # 1 一种模式,在这种模式下,预览中的面向页被查看 QPrintPreviewWidget.AllPagesView # 2 查看模式,其中查看预览中的所有页面 # 描述预览小部件的缩放模式 QPrintPreviewWidget.ZoomMode QPrintPreviewWidget.CustomZoom # 0 缩放设置为自定义缩放值 QPrintPreviewWidget.FitToWidth # 1 此模式使当前页面适合于视图的宽度 QPrintPreviewWidget.FitInView # 2 此模式适合视图内的当前页面
- 常用API
# 构造函数 # 构造一个QPrintPreviewWidget对象 QPrintPreviewWidget() # 构造一个QPrintPreviewWidget对象,指定父控件的同时设置窗口标志 QPrintPreviewWidget(QWidget *parent = nullptr, Qt.WindowFlags flags = Qt.WindowFlags()) # 构造一个基于打印机的QPrintPreviewWidget对象,指定父控件的同时设置窗口标志 QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt.WindowFlags flags = Qt.WindowFlags()) currentPage() # 返回预览中当前查看的页面 orientation() # 返回预览的当前方向 pageCount() # 返回预览中的页数 viewMode() # 返回当前视图模式。默认的视图模式是SinglePageView zoomFactor() # 返回视图的缩放系数 zoomMode() # 返回当前缩放模式 setVisible(bool visible) print() # 将预览打印到与预览相关联的打印机 updatePreview() # 更新预览,这会导致paintrerequested()信号被发出 zoomIn(qreal factor = 1.1) # 按比例放大当前视图。factor的默认值是1.1 zoomOut(qreal factor = 1.1) # 按比例缩小当前视图。factor的默认值是1.1 setViewMode(QPrintPreviewWidget.ViewMode mode) # 根据索引设置视图模式。默认的视图模式是SinglePageView setAllPagesViewMode() # 设置视图模式为AllPagesView,与调用 setViewMode(QPrintPreviewWidget.AllPagesView)相同 setFacingPagesViewMode() # 设置视图模式为FacingPagesView,与调用 setViewMode(QPrintPreviewWidget.FacingPagesView)相同 setSinglePageViewMode() # 设置视图模式为SinglePageView,与调用 setViewMode(QPrintPreviewWidget.SinglePageView)相同 setCurrentPage(int page) # 在预览中设置当前页面。这将导致视图跳转到页面的开头 setOrientation(QPrinter.Orientation orientation) # 根据索引设置当前方向 setLandscapeOrientation() # 设置当前方向为Landscape,与调用setOrientation(QPrinter.Landscape)相同 setPortraitOrientation() # 设置当前方向为Portrait,与调用 setOrientation(QPrinter.Portrait)相同 setZoomFactor(qreal factor) # 设置视图的缩放系数 setZoomMode(QPrintPreviewWidget.ZoomMode zoomMode) # 根据索引设置缩放模式。默认的缩放模式是FitInView fitInView() # 设置缩放模式为FitInView,与调用setZoomMode(QPrintPreviewWidget.FitInView)相同 fitToWidth() # 设置缩放模式为FitToWidth,与调用setZoomMode(QPrintPreviewWidget.FitToWidth)相同
- 可用信号
paintRequested(QPrinter *printer) # 当预览小部件需要生成一组预览页面时,就会发出这个信号,Printer是与这个预览小部件关联的打印机 previewChanged() # 每当预览小部件改变了某些内部状态(比如方向)时,就会发出这个信号
QPrintPreviewDialog
- 描述
- 用于预览和配置打印机输出的页面布局的对话框
- 可以用现有的QPrinter对象构造一个QPrintPreviewDialog
- 也可以让QPrintPreviewDialog为您创建一个QPrintPreviewDialog,它将是系统默认的打印机
- 将paintrerequested()信号连接到插槽。当对话框需要生成一组预览页面时,paintrerequested()信号将被发出
- 继承自:QDialog
- 常用API
# 构造函数 QPrintPreviewDialog() # 创建一个内部QPrinter对象,该对象将使用系统默认打印机 QPrintPreviewDialog(QWidget *parent = nullptr, Qt.WindowFlags flags = Qt.WindowFlags()) # 构造一个基于指定打印机的QPrintPreviewDialog对象,并以parent作为父部件 QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt.WindowFlags flags = Qt.WindowFlags()) done(int result) # 关闭对话框并将其结果代码设置为result # 重写 QDialog.done(int r) # 如果使用exec()显示此对话框,done()也会导致本地事件循环结束,并且exec()返回result open(QObject *receiver, const char *member) # 打开对话框并将其完成的(int)信号连接到由接收器和成员指定的插槽 printer() # 返回与QPrintPreviewDialog关联的QPrinter对象 setVisible(bool visible) # 是否可见
- 可用信号
paintRequested(QPrinter *printer) # 当生成一组预览页面时,就会发出这个信号 # 所提供的打印机实例是绘制设备,您应该在其上绘制每个页面的内容,使用QPrinter实例的方式与直接打印时的方式相同
QPrintEngine
- 描述
- 用于预览和配置打印机输出的页面布局的对话框
- QPrintEngine类定义了一个接口,用于QPrinter如何与给定的打印子系统交互
- 在创建自己的打印引擎时,常见的情况是同时从QPaintEngine和QPrintEngine派生
- 打印引擎的各种属性由property()给出,并由setProperty()设置。
- 继承自:simplewrapper
- 枚举
- QPrintEngine.PrintEnginePropertyKey
- 用于打印引擎和QPrinter之间的属性通信。给定的打印引擎可能支持也可能不支持某个属性
QPrintEngine.PrintEnginePropertyKey # QPrintEngine.PPK_CollateCopies # 0 一个布尔值,指示是否应该对打印输出进行排序 # QPrintEngine.PPK_ColorMode # 1 指Qprinter.ColorMode,可以是彩色的,也可以是单色的 # QPrintEngine.PPK_Creator # 2 描述文档创建者的字符串 # QPrintEngine.PPK_Duplex # 20 一个布尔值,指示是否应将打印纸的两面用于打印输出 # QPrintEngine.PPK_DocumentName # 3 在假脱机程序中描述文档名称的字符串 # QPrintEngine.PPK_FontEmbedding # 19 一个布尔值,指示文档字体的数据是否应该嵌入到发送到打印机的数据中 # QPrintEngine.PPK_FullPage # 4 一个布尔值,描述打印机是否应该满页 # QPrintEngine.PPK_Orientation # 6 指定Qprinter.Orientation值 # QPrintEngine.PPK_OutputFileName # 7 以字符串形式输出文件名。空文件名表示打印机不应该打印到某个文件 # QPrintEngine.PPK_PageOrder # 8 指定Qprinter.PageOrder值 # QPrintEngine.PPK_PageRect # 9 指定页面矩形的QRect # QPrintEngine.PPK_PaperRect # 11 指定纸张矩形的QRect # QPrintEngine.PPK_PaperSource # 12 指定Qprinter.PaperSource值 # QPrintEngine.PPK_PaperSources # 21 指定多个QPrinter.PaperSource值 # QPrintEngine.PPK_PaperName # 26 指定论文名称的字符串 # QPrintEngine.PPK_PaperSize # PPK_PageSize 指定QPrinter.PaperSize值 # QPrintEngine.PPK_PrinterName # 13 指定打印机名称的字符串 # QPrintEngine.PPK_PrinterProgram # 14 指定用于打印的打印机程序名称的字符串 # QPrintEngine.PPK_Resolution # 15 描述这台打印机每英寸网点数的整数 # QPrintEngine.PPK_SelectionOption # 16 # QPrintEngine.PPK_SupportedResolutions # 17 描述打印机支持的一组分辨率的整数QVariant列表 # QPrintEngine.PPK_WindowsPageSize # 18 在Windows上指定DM_PAPER条目的整数 # QPrintEngine.PPK_CustomPaperSize # 22 在QPrinter.Point单位中指定自定义纸张大小的QSizeF # QPrintEngine.PPK_PageMargins # 23 一个QList<QVariant>,包含QPrinter.Point单元中的左、上、右和下边距值 # QPrintEngine.PPK_CopyCount # 24 指定要打印的副本数量的整数 # QPrintEngine.PPK_SupportsMultipleCopies # 25 一个布尔值,指示打印机是否支持在一个作业中打印多个副本 # QPrintEngine.PPK_QPageSize # 27 使用QPageSize对象设置页面大小 # QPrintEngine.PPK_QPageMargins # 28 使用QMarginsF和QPageLayout.Unit的QPair设置页边距 # QPrintEngine.PPK_QPageLayout # 29 使用QPageLayout对象设置页面布局 # QPrintEngine.PPK_CustomBase # 0xff00 扩展的基础
- 常用API
QPrintEngine() # 构造函数 abort() # 指示打印引擎中止打印过程。如果成功返回true;否则返回false printerState() # 返回打印引擎正在使用的打印机的当前状态 newPage() # 指示打印引擎开始一个新页面。如果打印机能够创建新页面,则返回true;否则返回false metric(QPaintDevice.PaintDeviceMetric id) # 返回给定id的度量 property(QPrintEngine.PrintEnginePropertyKey key) # 返回由键指定的打印引擎属性 setProperty(QPrintEngine.PrintEnginePropertyKey key, const QVariant &value) # 将键指定的打印引擎属性设置为给定值
QPrinterInfo
- 描述
- 提供对现有打印机信息的访问
- 使用静态函数生成QPrinterInfo对象列表。
- 列表中的每个QPrinterInfo对象表示一台打印机,可以查询名称、支持的纸张大小以及它是否是默认打印机
- 继承自:simplewrapper
- 常用API
QPrinterInfo() # 构造一个空的QPrinterInfo对象 QPrinterInfo(const QPrinter &printer) # 从printer构造一个QPrinterInfo对象 QPrinterInfo(const QPrinterInfo &other) # 构造other的副本 QPrinterInfo.operator=(const QPrinterInfo &other) # 设置QPrinterInfo对象等于other availablePrinterNames() # 返回此系统上所有可用打印机名称的列表 # 建议使用此方法而不是availablePrinters(),因为它在大多数系统上会更快。 # 请注意,如果在本地系统或远程打印服务器上进行了更改,该列表可能会过时 # 只在需要时实例化所需的QPrinterInfo实例,并在调用之前始终检查有效性 availablePrinters() # 返回系统中所有可用打印机的QPrinterInfo对象列表 # 不建议使用此方法,因为创建每个打印机实例可能需要很长时间,特别是在存在远程联网打印机的情况下 # 并且如果在本地系统或远程打印服务器上进行更改,保留的实例可能会过时 defaultColorMode() # 返回此打印机的默认颜色模式 defaultDuplexMode() # 返回此打印机的默认双工模式 defaultPageSize() # 返回此打印机的当前默认页面大小 defaultPrinter() # 返回系统上的默认打印机 # 在使用返回值之前,应该使用isNull()检查返回值,以防没有默认打印机。 defaultPrinterName() # 返回当前默认打印机名称 description() # 返回打印机的可读描述 isDefault() # 返回此打印机当前是否为默认打印机 isNull() # 返回QPrinterInfo对象是否包含打印机定义。 # 例如,当系统上没有打印机时,调用defaultPrinter()可能会产生一个空的QPrinterInfo对象 isRemote() # 返回此打印机是否为远程网络打印机 location() # 返回打印机的可读位置 makeAndModel () # 返回可读打印机的品牌和型号 maximumPhysicalPageSize () # 返回此打印机支持的最大物理页面大小 minimumPhysicalPageSize() # 返回此打印机支持的最小物理页面大小 printerInfo(const QString &printerName) # 返回打印机prinintername # 在使用返回值之前应该使用isNull()进行检查,以防指定的打印机不存在 printerName() # 返回打印机的名称 state() # 返回该打印机的当前状态 supportedColorModes() # 返回此打印机支持的颜色模式 supportedDuplexModes() # 返返回此打印机支持的双工模式列表 supportedPageSizes() # 返回此打印机支持的页面大小列表 supportedResolutions() # 返回此打印机支持的分辨率列表 supportsCustomPageSizes() # 返回此打印机是否支持自定义页面大小