# QPrintEngine Class Reference ## [[QtGui](index.htm) module] 該QPrintEngine類定義一個接口，用于如何[QPrinter](qprinter.html)交互與給定的打印子系統。[More...](#details) ### Types * `enum PrintEnginePropertyKey { PPK_CollateCopies, PPK_ColorMode, PPK_Creator, PPK_DocumentName, ..., PPK_CustomBase }` ### Methods * `__init__ (self)` * `__init__ (self, QPrintEngine)` * `bool abort (self)` * `int metric (self, QPaintDevice.PaintDeviceMetric)` * `bool newPage (self)` * `QPrinter.PrinterState printerState (self)` * `QVariant property (self, PrintEnginePropertyKey?key)` * `setProperty (self, PrintEnginePropertyKey?key, QVariant?value)` * * * ## Detailed Description 該QPrintEngine類定義一個接口，用于如何[QPrinter](qprinter.html)交互與給定的打印子系統。 創建您自己的打印引擎時常見的情況是從兩個派生[QPaintEngine](qpaintengine.html)和QPrintEngine 。打印引擎的各種性質都給予[property](qprintengine.html#property)（ ），并設置用[setProperty](qprintengine.html#setProperty)（ ） 。 * * * ## Type Documentation ``` QPrintEngine.PrintEnginePropertyKey ``` 該枚舉用于打印引擎之間的通信性能和[QPrinter](qprinter.html)。一個屬性可能會或可能不會被給定的打印引擎的支持。 | Constant | Value | Description | | --- | --- | --- | | `QPrintEngine.PPK_CollateCopies` | `0` | 一個布爾值，表示打印輸出是否應該整理與否。 | | `QPrintEngine.PPK_ColorMode` | `1` | 指[QPrinter.ColorMode](qprinter.html#ColorMode-enum)，無論是彩色還是黑白。 | | `QPrintEngine.PPK_Creator` | `2` | 一個字符串，描述了文檔的創建者。 | | `QPrintEngine.PPK_Duplex` | `21` | 一個布爾值，指示是否應該用于打印輸出的打印機紙張的兩面。 | | `QPrintEngine.PPK_DocumentName` | `3` | 一個字符串，描述在后臺打印程序的文件名。 | | `QPrintEngine.PPK_FontEmbedding` | `19` | 一個布爾值，表示該文檔的字體數據是否應該被嵌入在發送到打印機的數據。 | | `QPrintEngine.PPK_FullPage` | `4` | 一個布爾值，說明如果打印機應該是整頁或沒有。 | | `QPrintEngine.PPK_NumberOfCopies` | `5` | 已過時。一個整數，指定打印份數。使用PPK_CopyCount代替。 | | `QPrintEngine.PPK_Orientation` | `6` | 指定[QPrinter.Orientation](qprinter.html#Orientation-enum)值。 | | `QPrintEngine.PPK_OutputFileName` | `7` | 輸出文件名作為一個字符串。一個空的文件名表示打印機不能打印到文件。 | | `QPrintEngine.PPK_PageOrder` | `8` | 指定[QPrinter.PageOrder](qprinter.html#PageOrder-enum)值。 | | `QPrintEngine.PPK_PageRect` | `9` | A [QRect](qrect.html)指定頁面的矩形 | | `QPrintEngine.PPK_PageSize` | `10` | 已過時。使用PPK_PaperSize代替。 | | `QPrintEngine.PPK_PaperRect` | `11` | A [QRect](qrect.html)指定紙張的矩形。 | | `QPrintEngine.PPK_PaperSource` | `12` | 指定[QPrinter.PaperSource](qprinter.html#PaperSource-enum)值。 | | `QPrintEngine.PPK_PaperSources` | `22` | 指定多于一個[QPrinter.PaperSource](qprinter.html#PaperSource-enum)值。 | | `QPrintEngine.PPK_PaperSize` | `PPK_PageSize` | 指定[QPrinter.PaperSize](qprinter.html#PaperSize-enum)值。 | | `QPrintEngine.PPK_PrinterName` | `13` | 一個字符串，指定打印機的名稱。 | | `QPrintEngine.PPK_PrinterProgram` | `14` | 一個字符串，指定用于打印的打印機程序的名稱， | | `QPrintEngine.PPK_Resolution` | `15` | 一個整數描述每英寸點數為這臺打印機。 | | `QPrintEngine.PPK_SelectionOption` | `16` | ? | | `QPrintEngine.PPK_SupportedResolutions` | `17` | 整數列表[QVariants](index.htm#qvariants)描述一組打印機有支持的分辨率。 | | `QPrintEngine.PPK_SuppressSystemPrintStatus` | `20` | 打壓展示印刷進步的內置對話框。由于4.1本只有在Mac OS X，其中，在默認情況下，會顯示一個狀態對話框的效果。 | | `QPrintEngine.PPK_WindowsPageSize` | `18` | 一個整數，指定在Windows上DM_PAPER條目。 | | `QPrintEngine.PPK_CustomPaperSize` | `23` | A [QSizeF](qsizef.html)在指定自定義紙張尺寸[QPrinter.Point](qprinter.html#Unit-enum)單元。 | | `QPrintEngine.PPK_PageMargins` | `24` | A [QList](index.htm)\u003c[QVariant](qvariant.html)\u003e包含左，上，右，下邊距值。 | | `QPrintEngine.PPK_CopyCount` | `25` | 一個整數，指定要打印的副本數。 | | `QPrintEngine.PPK_SupportsMultipleCopies` | `26` | 一個布爾值，表示打印機是否支持打印多份在一個作業。 | | `QPrintEngine.PPK_CustomBase` | `0xff00` | 為擴展的基礎。 | * * * ## Method Documentation ``` QPrintEngine.__init__ (self) ``` ``` QPrintEngine.__init__ (self, QPrintEngine) ``` ``` bool QPrintEngine.abort (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 指示打印引擎，中止打印處理。成功返回True ，否則返回False 。 ``` int QPrintEngine.metric (self, QPaintDevice.PaintDeviceMetric) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回度量給定的_id_。 ``` bool QPrintEngine.newPage (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 指示打印引擎啟動一個新的頁面。返回True如果打印機能夠創建新的頁面，否則返回False 。 ``` QPrinter.PrinterState QPrintEngine.printerState (self) ``` [ 這種方法是抽象的，應在任何子類中重新實現。 返回正在使用的打印引擎的打印機的當前狀態。 ``` QVariant QPrintEngine.property (self, PrintEnginePropertyKey?key) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回由指定的打印引擎的財產_key_。 ](qprinter.html#PrinterState-enum) [**See also**](qprinter.html#PrinterState-enum) [setProperty](qprintengine.html#setProperty)（ ） 。 ``` QPrintEngine.setProperty (self, PrintEnginePropertyKey?key, QVariant?value) ``` 這種方法是抽象的，應在任何子類中重新實現。 設置由指定的打印引擎的財產_key_為給定的_value_。 **See also** [property](qprintengine.html#property)（ ） 。