class QPrintDialog#

PySide6.QtPrintSupport.QPrintDialog类提供了一个对话框来指定打印机的配置。更多...

概述#

属性#

options - 影响对话框外观和感觉的各个选项

方法#

def __init__()
def exec_()
def open()
def options()
def setOption()
定义 setOptions()
定义 testOption()

信号#

定义 accepted()

注意

这份文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您在翻译中发现问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述#

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

此对话框允许用户更改与文档相关的设置，例如纸张大小和方向、打印类型（彩色或灰度）、页面范围和打印份数。

还提供了控件，以使用户可以选择可用的打印机，包括任何配置的网络打印机。

通常，使用带有 QPrinter 对象的 QPrintDialog 对象，并通过 exec() 函数执行。

printDialog = QPrintDialog(printer, parent)
if printDialog.exec() == QDialog.Accepted:
    # print ...

如果用户接受该对话框，则 QPrinter 对象将正确配置以进行打印。

打印机对话框（如图所示为Plastique样式）允许访问常用的打印属性。在X11平台上，使用CUPS打印系统的平台，可以通过对话框的“属性”推按钮修改每个可用打印机的设置。

在Windows和macOS上，使用的是本机打印对话框，这意味着对话框上设置的某些 QWidget 和 QDialog 属性将不被尊重。macOS上的本机打印对话框不支持设置打印机选项，即 setOptions() 和 setOption() 无效。

在Qt 4.4中，可以使用静态函数在macOS上显示页面。在Qt 4.5中不再支持此功能。如果您需要此功能，请使用 open() 。

另请参阅

QPageSetupDialog QPrinter

注意

可以在使用 from __feature__ import true_property 的情况下直接使用属性，或者通过访问器函数在其他情况下使用。

属性 options : QAbstractPrintDialog.PrintDialogOption组合#

此属性包含影响对话框外观和感觉的各种选项。

默认情况下，所有选项都不可用。

应在显示对话框之前设置选项。在对话框可见时设置它们不会保证立即对对话框产生影响（取决于选项和平台）。

另请参阅

setOption() testOption()

访问函数

options()
setOptions()

__init__(printer[, parent=None])#

参数：

printer – QPrinter
parent – QWidget

构建一个新的模态打印机对话框，用于给定的 printer 和 parent。

__init__([parent=None])

参数：: parent – QWidget

构建一个带有给定的 parent 的打印对话框。

accepted(printer)#

参数：: printer – QPrinter

当用户接受在打印对话框中设置的值时发出此信号。该 printer 参数包含已应用设置的目标打印机。

exec_()#

返回类型：: int

open(receiver, member)#

参数：

receiver – QObject
member – str

这是一个重载函数。

打开对话框，将其 accepted() 信号连接到由 receiver 和 member 指定的槽。

对话框关闭时，信号将从槽断开。

options()#

返回类型：: 结合 PrintDialogOption

另请参阅

setOptions()

获取属性 optionsᅟ 的 getter。

setOption(option[, on=true])#

参数：

option – PrintDialogOption
on – bool

如果 on 为真，则将指定的 option 设置为启用；否则清除指定的 option。

另请参阅

options testOption()

setOptions(options)#

参数：: options – PrintDialogOption 结合

另请参阅

options()

设置属性 optionsᅟ 的 setter。

testOption(option)#

参数：: option – PrintDialogOption
返回类型：: bool

如果给定的 option 启用，则返回 true；否则返回 false。

另请参阅

options setOption()