# QPrintDialog Class Reference ## [[QtGui](index.htm) module] 該QPrintDialog中類提供用于指定打印機的配置對話框。[More...](#details) 繼承[QAbstractPrintDialog](qabstractprintdialog.html)。 ### Methods * `__init__ (self, QPrinter?printer, QWidget?parent?=?None)` * `__init__ (self, QWidget?parent?=?None)` * `accept (self)` * `accepted (self)` * `done (self, int?result)` * `int exec_ (self)` * `open (self)` * `open (self, QObject?receiver, SLOT()SLOT()?member)` * `open (self, callable?receiver)` * `QAbstractPrintDialog.PrintDialogOptions options (self)` * `setOption (self, QAbstractPrintDialog.PrintDialogOption?option, bool?on?=?True)` * `setOptions (self, QAbstractPrintDialog.PrintDialogOptions?options)` * `setVisible (self, bool?visible)` * `bool testOption (self, QAbstractPrintDialog.PrintDialogOption?option)` ### Qt Signals * `void accepted (QPrinter *)` * * * ## Detailed Description 該QPrintDialog中類提供用于指定打印機的配置對話框。 該對話框允許用戶更改文件相關的設置，如紙張大小和方向，打印（彩色或灰階）類型，頁數范圍，以及要打印的副本數。 還提供控制，以使用戶能夠從現有的打印機，包括任何已配置網絡打印機進行選擇。 通常情況下， QPrintDialog中對象與構造[QPrinter](qprinter.html)對象，并使用所執行的[exec_](qprintdialog.html#exec)（）函數。 ``` QPrintDialog printDialog(printer, parent); if (printDialog.exec() == [QDialog](qdialog.html).Accepted) { // print ... } ``` 如果對話框被用戶接受，則[QPrinter](qprinter.html)對象被正確配置打印。 |  |  | 打印機對話框（在PLASTIQUE風格如上圖所示）可以訪問常用的印刷性能。在使用CUPS打印系統的X11平臺，為每個可用的打印機的設置可以通過對話框的修改**Properties**按下按鈕。 在Windows和Mac OS X ，則使用本機打印對話框，這意味著一些[QWidget](qwidget.html)和[QDialog](qdialog.html)在對話框中設置的屬性不會被尊重。在Mac OS X上的本機打印對話框不支持設置打印機選項，即[setOptions](qprintdialog.html#options-prop)（）和[setOption](qprintdialog.html#setOption)（ ）沒有任何效果。 在Qt 4.4 ，它是可以使用的靜態函數，以顯示在Mac OS X上的這片已經不再在Qt的4.5的支持。如果你想要這個功能，使用[QPrintDialog.open](qprintdialog.html#open)（ ） 。 * * * ## Method Documentation ``` QPrintDialog.__init__ (self, QPrinter?printer, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個新的模態對話框的打印機為給定的_printer_用給定的_parent_。 ``` QPrintDialog.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個打印對話框給定的_parent_。 ``` QPrintDialog.accept (self) ``` ``` QPrintDialog.accepted (self) ``` 當用戶接受在打印對話框中設置的值，這個信號被發射。該_printer_參數包括該設置被應用到打印機。 ``` QPrintDialog.done (self, int?result) ``` 從重新實現[QDialog.done](qdialog.html#done)（ ） 。 關閉對話框，并將其結果代碼_result_。如果顯示此對話框[exec_](qprintdialog.html#exec)（ ） ， （）完成將導致本地事件循環來完成，并[exec_](qprintdialog.html#exec)（ ）返回_result_。 **See also** [QDialog.done](qdialog.html#done)（ ） 。 ``` int QPrintDialog.exec_ (self) ``` 從重新實現[QAbstractPrintDialog.exec](qabstractprintdialog.html#exec)（ ） 。 ``` QPrintDialog.open (self) ``` 這是一個重載函數。 在打開的對話框并連接其[accepted](qprintdialog.html#accepted)（）信號到由指定的槽_receiver_和_member_。 該信號會從插槽中斷開時，關閉對話框。 此功能被引入Qt的4.5 。 ``` QPrintDialog.open (self, QObject?receiver, SLOT()SLOT()?member) ``` ``` QPrintDialog.open (self, callable?receiver) ``` ``` QAbstractPrintDialog.PrintDialogOptions QPrintDialog.options (self) ``` [ ``` QPrintDialog.setOption (self, QAbstractPrintDialog.PrintDialogOption?option, bool?on?=?True) ``` 設置給定_option_被啟用，如果_on_是真的，否則，清除給定的_option_。 ](index.htm) [**See also**](index.htm) [options](qprintdialog.html#options-prop)和[testOption](qprintdialog.html#testOption)（ ） 。 ``` QPrintDialog.setOptions (self, QAbstractPrintDialog.PrintDialogOptions?options) ``` ``` QPrintDialog.setVisible (self, bool?visible) ``` 從重新實現[QWidget.setVisible](qwidget.html#visible-prop)（ ） 。 ``` bool QPrintDialog.testOption (self, QAbstractPrintDialog.PrintDialogOption?option) ``` 返回True如果給定的_option_被啟用，否則返回False 。 **See also** [options](qprintdialog.html#options-prop)和[setOption](qprintdialog.html#setOption)（ ） 。 * * * ## Qt Signal Documentation ``` void accepted (QPrinter *) ``` 這是該信號的默認超載。