PySide6.QtPrintSupport.QPrintDialog¶

class QPrintDialog¶

QPrintDialog 类提供了一个对话框，用于指定打印机的配置。更多…

概要¶

属性¶

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

方法¶

• def __init__()

• def exec_()

• def open()

• def options()

• def setOption()

• def setOptions()

• def testOption()

信号¶

• def accepted()

注意

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

详细描述¶

警告

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

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

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

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

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

如果用户接受了对话框，QPrinter对象将正确配置为打印。

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

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

在Qt 4.4中，可以使用静态函数在macOS上显示一个表单。这在Qt 4.5中不再支持。如果你需要这个功能，请使用open()。

另请参阅

QPageSetupDialog QPrinter

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property optionsᅟ: Combination of QAbstractPrintDialog.PrintDialogOption¶

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

默认情况下，所有选项都被禁用。

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

另请参阅

setOption() testOption()

Access functions:

• options()

• setOptions()

__init__([parent=None])¶

Parameters:

父级 – QWidget

使用给定的parent构建一个打印对话框。

__init__(printer[, parent=None])

Parameters:

• 打印机 – QPrinter

• parent – QWidget

为给定的printer和parent构造一个新的模态打印机对话框。

accepted(printer)¶

Parameters:

打印机 – QPrinter

当用户接受打印对话框中设置的值时，会发出此信号。printer 参数包括应用了设置的打印机。

exec_()¶

Return type:

整数

open(receiver, member)¶

Parameters:

• receiver – QObject

• member – str

这是一个重载函数。

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

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

options()¶

Return type:

PrintDialogOption 的组合

另请参阅

setOptions()

属性 optionsᅟ 的获取器。

setOption(option[, on=true])¶

Parameters:

• option – PrintDialogOption

• on – 布尔值

如果on为真，则启用给定的option；否则，清除给定的option。

另请参阅

options testOption()

setOptions(options)¶

Parameters:

options – PrintDialogOption 的组合

另请参阅

options()

属性 optionsᅟ 的设置器。

testOption(option)¶

Parameters:

选项 – PrintDialogOption

Return type:

布尔

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

另请参阅

options setOption()