QPrinter Class Reference · PyQt4 中文文檔

# QPrinter Class Reference ## [[QtGui](index.htm) module] 該QPrinter做類是涂料設備，油漆上的打印機。[More...](#details) 繼承[QPaintDevice](qpaintdevice.html)。 ### Types * `enum ColorMode { GrayScale, Color }` * `enum DuplexMode { DuplexNone, DuplexAuto, DuplexLongSide, DuplexShortSide }` * `enum Orientation { Portrait, Landscape }` * `enum OutputFormat { NativeFormat, PdfFormat, PostScriptFormat }` * `enum PageOrder { FirstPageFirst, LastPageFirst }` * `enum PageSize { A4, B5, Letter, Legal, ..., Custom }` * `enum PaperSource { OnlyOne, Lower, Middle, Manual, ..., MaxPageSource }` * `enum PrinterMode { ScreenResolution, PrinterResolution, HighResolution }` * `enum PrinterState { Idle, Active, Aborted, Error }` * `enum PrintRange { AllPages, Selection, PageRange, CurrentPage }` * `enum Unit { Millimeter, Point, Inch, Pica, ..., DevicePixel }` ### Methods * `__init__ (self, PrinterMode?mode?=?QPrinter.ScreenResolution)` * `__init__ (self, QPrinterInfo?printer, PrinterMode?mode?=?QPrinter.ScreenResolution)` * `bool abort (self)` * `int actualNumCopies (self)` * `bool collateCopies (self)` * `ColorMode colorMode (self)` * `int copyCount (self)` * `QString creator (self)` * `QString docName (self)` * `bool doubleSidedPrinting (self)` * `DuplexMode duplex (self)` * `bool fontEmbeddingEnabled (self)` * `int fromPage (self)` * `bool fullPage (self)` * `(float?left, float?top, float?right, float?bottom) getPageMargins (self, Unit?unit)` * `bool isValid (self)` * `int metric (self, QPaintDevice.PaintDeviceMetric)` * `bool newPage (self)` * `int numCopies (self)` * `Orientation orientation (self)` * `QString outputFileName (self)` * `OutputFormat outputFormat (self)` * `PageOrder pageOrder (self)` * `QRect pageRect (self)` * `QRectF pageRect (self, Unit)` * `PageSize pageSize (self)` * `QPaintEngine paintEngine (self)` * `QRect paperRect (self)` * `QRectF paperRect (self, Unit)` * `PageSize paperSize (self)` * `QSizeF paperSize (self, Unit?unit)` * `PaperSource paperSource (self)` * `QPrintEngine printEngine (self)` * `QString printerName (self)` * `QString printerSelectionOption (self)` * `PrinterState printerState (self)` * `QString printProgram (self)` * `PrintRange printRange (self)` * `int resolution (self)` * `setCollateCopies (self, bool?collate)` * `setColorMode (self, ColorMode)` * `setCopyCount (self, int)` * `setCreator (self, QString)` * `setDocName (self, QString)` * `setDoubleSidedPrinting (self, bool?enable)` * `setDuplex (self, DuplexMode?duplex)` * `setEngines (self, QPrintEngine?printEngine, QPaintEngine?paintEngine)` * `setFontEmbeddingEnabled (self, bool?enable)` * `setFromTo (self, int?fromPage, int?toPage)` * `setFullPage (self, bool)` * `setNumCopies (self, int)` * `setOrientation (self, Orientation)` * `setOutputFileName (self, QString)` * `setOutputFormat (self, OutputFormat?format)` * `setPageMargins (self, float?left, float?top, float?right, float?bottom, Unit?unit)` * `setPageOrder (self, PageOrder)` * `setPageSize (self, PageSize)` * `setPaperSize (self, PageSize)` * `setPaperSize (self, QSizeF?paperSize, Unit?unit)` * `setPaperSource (self, PaperSource)` * `setPrinterName (self, QString)` * `setPrinterSelectionOption (self, QString)` * `setPrintProgram (self, QString)` * `setPrintRange (self, PrintRange?range)` * `setResolution (self, int)` * `list-of-int supportedResolutions (self)` * `bool supportsMultipleCopies (self)` * `int toPage (self)` * * * ## Detailed Description 該QPrinter做類是涂料設備，油漆上的打印機。這個設備代表了一系列的打印輸出頁，并且被用在幾乎完全一樣的方式與其他涂料設備，如[QWidget](qwidget.html)和[QPixmap](qpixmap.html)。提供一組額外的功能來管理設備特定的功能，如方向和分辨率，并逐步在文檔中的頁面，因為它是生成的。直接打印在Windows或Mac OS X的打印機時， QPrinter則負責使用內置的打印機驅動程序。在X11上， QPrinter則負責使用[Common Unix Printing System (CUPS)](http://www.cups.org/)或標準Unix[lpr](http://www.ietf.org/rfc/rfc1179.txt#lpr)實用派的PostScript或PDF輸出到打印機。作為替代，本[printProgram](qprinter.html#printProgram)（）函數可以用來指定命令或工具來使用，而不是系統默認的。請注意，如紙張尺寸和分辨率上的一個無效的打印機設置參數是不確定的。您可以使用[QPrinter.isValid](qprinter.html#isValid)（）來更改任何參數之前驗證這一點。 QPrinter做支持多個參數，其中大部分可以通過一個最終用戶來改變[print dialog](qprintdialog.html)。在一般情況下， QPrinter做通過這些功能到底層[QPrintEngine](qprintengine.html)。最重要的參數是： * [setOrientation](qprinter.html#setOrientation)() tells QPrinter which page orientation to use. * [setPaperSize](qprinter.html#setPaperSize)() tells QPrinter what paper size to expect from the printer. * [setResolution](qprinter.html#setResolution)() tells QPrinter what resolution you wish the printer to provide, in dots per inch (DPI). * [setFullPage](qprinter.html#setFullPage)() tells QPrinter whether you want to deal with the full page or just with the part the printer can draw on. * [setCopyCount](qprinter.html#setCopyCount)() tells QPrinter how many copies of the document it should print. 實際印刷開始之前許多這些功能只能叫（即前[QPainter.begin](qpainter.html#begin)（）被調用）。這通常是有道理的，因為，例如，它是不可能的，當你中途印刷改變的份數。也有一些用戶設置（通過打印機對話框），并且應用程序都應該遵守的一些設置。看[QAbstractPrintDialog](qabstractprintdialog.html)的文檔了解更多信息。 When [QPainter.begin](qpainter.html#begin)（）被調用時，它運行在QPrinter做準備一個新的頁面，從而使[QPainter](qpainter.html)要立即用于油漆中的第一頁的文檔。一旦第一個頁面已經被畫，[newPage](qprinter.html#newPage)（）可以調用請求一個新的空白頁面上繪制，或[QPainter.end](qpainter.html#end)（）可以被調用來完成打印。第二頁和之后的所有頁面都通過調用準備[newPage](qprinter.html#newPage)（）它們都畫前。在文檔的第一頁也不需要在前面加上一個呼叫到[newPage](qprinter.html#newPage)（）。你只需要調用[newPage](qprinter.html#newPage)（）后[QPainter.begin](qpainter.html#begin)（）如果你需要打印的文檔的開頭插入一個空白頁。同樣，調用[newPage](qprinter.html#newPage)（）中的文件的最后一頁被涂之后，將導致附加到印刷文件的末尾的后空白頁。如果你想中止打印作業，[abort](qprinter.html#abort)（）將盡最大努力停止打印。它可能會取消整個作業或只是其中的一部分。由于QPrinter做可以打印到任何[QPrintEngine](qprintengine.html)子類，它可以擴展打印支持通過子類化，以包括新類型的印刷子系統[QPrintEngine](qprintengine.html)并重新實現它的接口。 * * * ## Type Documentation ``` QPrinter.ColorMode ``` 該枚舉類型用于指示是否[QPrinter](qprinter.html)應該在顏色或不打印。 | Constant | Value | Description | | --- | --- | --- | | `QPrinter.Color` | `1` | 彩色打印如果可用，否則是灰色的。 | | `QPrinter.GrayScale` | `0` | 灰度打印，即使在彩色打印機。 | ``` QPrinter.DuplexMode ``` 該枚舉用于指示是否將發生在紙（單面或雙面印刷），每個片材的一側或兩側上印刷。 | Constant | Value | Description | | --- | --- | --- | | `QPrinter.DuplexNone` | `0` | 單面（單面）打印只。 | | `QPrinter.DuplexAuto` | `1` | 打印機的默認設置是用來判斷雙面打印是否被使用。 | | `QPrinter.DuplexLongSide` | `2` | 每張紙的兩面都用于印刷。將紙張翻過來的最長邊的第二面打印之前 | | `QPrinter.DuplexShortSide` | `3` | 每張紙的兩面都用于印刷。將紙張翻過來的最短邊的第二面打印之前 | 這個枚舉被引入或修改的Qt 4.4 。 ``` QPrinter.Orientation ``` 該枚舉類型（不要與混淆`Orientation`）被用來指定每個頁面的方向。 | Constant | Value | Description | | --- | --- | --- | | `QPrinter.Portrait` | `0` | 頁面的高度大于它的寬度。 | | `QPrinter.Landscape` | `1` | 該頁面的寬度大于它的高度。 | 這種類型的交互[QPrinter.PaperSize](qprinter.html#PaperSize-enum)和[QPrinter.setFullPage](qprinter.html#setFullPage)（）來判斷頁面的最終尺寸提供給應用程序。 ``` QPrinter.OutputFormat ``` 的OutputFormat枚舉用于描述的格式[QPrinter](qprinter.html)應該使用進行打印。 | Constant | Value | Description | | --- | --- | --- | | `QPrinter.NativeFormat` | `0` | [QPrinter](qprinter.html)將使用由它運行的平臺定義的方法打印輸出。這種模式是默認的直接打印到打印機時。 | | `QPrinter.PdfFormat` | `1` | [QPrinter](qprinter.html)會產生它的輸出作為一個可搜索的PDF文件。這種模式是默認的打印到文件時。 | | `QPrinter.PostScriptFormat` | `2` | [QPrinter](qprinter.html)將產生其輸出作為在PostScript格式。（此功能被引入的Qt 4.2 。） | **See also** [outputFormat](qprinter.html#outputFormat)（）[setOutputFormat](qprinter.html#setOutputFormat)（）和[setOutputFileName](qprinter.html#setOutputFileName)（）。 ``` QPrinter.PageOrder ``` 該枚舉類型用于通過[QPrinter](qprinter.html)告訴應用程序如何打印。 | Constant | Value | Description | | --- | --- | --- | | `QPrinter.FirstPageFirst` | `0` | 編號最小的頁面應該先打印出來。 | | `QPrinter.LastPageFirst` | `1` | 最高編號的頁面應該先打印出來。 | ``` QPrinter.PageSize ``` ``` QPrinter.PaperSource ``` 該枚舉類型指定了紙張來源[QPrinter](qprinter.html)是使用。[QPrinter](qprinter.html)不檢查紙張來源是否可用;它只是使用這些信息來嘗試并設置紙張來源。它是否將設置紙張來源取決于打印機是否具有特定源。 **Warning:**這是目前唯一實現適用于Windows 。 | Constant | Value | | --- | --- | | `QPrinter.Auto` | `6` | | `QPrinter.Cassette` | `11` | | `QPrinter.Envelope` | `4` | | `QPrinter.EnvelopeManual` | `5` | | `QPrinter.FormSource` | `12` | | `QPrinter.LargeCapacity` | `10` | | `QPrinter.LargeFormat` | `9` | | `QPrinter.Lower` | `1` | | `QPrinter.MaxPageSource` | `13` | | `QPrinter.Middle` | `2` | | `QPrinter.Manual` | `3` | | `QPrinter.OnlyOne` | `0` | | `QPrinter.Tractor` | `7` | | `QPrinter.SmallFormat` | `8` | ``` QPrinter.PrinterMode ``` 這個枚舉變量描述模式的打印機應該工作。它基本上是預置了一定的分辨率和工作模式。 | Constant | Value | Description | | --- | --- | --- | | `QPrinter.ScreenResolution` | `0` | 設置打印設備屏幕分辨率的分辨率。這具有很大的優勢打印機上繪制時所獲得的結果將在屏幕上可見的輸出相匹配或多或少確切。這是最容易使用，在屏幕上和打印機上的字體度量標準是相同的。這是默認值。 ScreenResolution會產生低質量的輸出比高分辨率，應該只用于草稿。 | | `QPrinter.PrinterResolution` | `1` | 此值已棄用。是相當于ScreenResolution在Unix和高分辨率在Windows和Mac 。由于做ScreenResolution和高分辨率之間的區別，使用這個值可能會導致非便攜式打印機的代碼。 | | `QPrinter.HighResolution` | `2` | 在Windows上，設置打印機分辨率，對于所使用的打印機定義。對于PostScript打印，設置PostScript驅動程序為1200 dpi的分辨率。 | **Note:**當在呈現文本[QPrinter](qprinter.html)裝置中，要認識到，文字的大小，當在指定的點，是獨立于裝置本身所指定的分辨率是重要的。因此，它可能是有用的，當結合文字與圖形，以確保它們的相對大小是您所期望的指定以像素為單位的字體大小。 ``` QPrinter.PrinterState ``` | Constant | Value | | --- | --- | | `QPrinter.Idle` | `0` | | `QPrinter.Active` | `1` | | `QPrinter.Aborted` | `2` | | `QPrinter.Error` | `3` | ``` QPrinter.PrintRange ``` 用于指定打印范圍選擇選項。 | Constant | Value | Description | | --- | --- | --- | | `QPrinter.AllPages` | `0` | 所有網頁應打印。 | | `QPrinter.Selection` | `1` | 唯一的選擇應打印。 | | `QPrinter.PageRange` | `2` | 指定頁面范圍應打印。 | | `QPrinter.CurrentPage` | `3` | 只有當前頁面應該被打印出來。 | **See also** [QAbstractPrintDialog.PrintRange](qabstractprintdialog.html#PrintRange-enum)。 ``` QPrinter.Unit ``` 該枚舉類型用于指定的測量單位為頁和紙張尺寸。 | Constant | Value | | --- | --- | | `QPrinter.Millimeter` | `0` | | `QPrinter.Point` | `1` | | `QPrinter.Inch` | `2` | | `QPrinter.Pica` | `3` | | `QPrinter.Didot` | `4` | | `QPrinter.Cicero` | `5` | | `QPrinter.DevicePixel` | `6` | 注意點和DevicePixel之間的差異。的點部被定義為一英寸的1/72th ，而DevicePixel單元是分辨率依賴，并基于實際的像素，或點，在打印機上。這個枚舉被引入或修改的Qt 4.4 。 * * * ## Method Documentation ``` QPrinter.__init__ (self, PrinterMode?mode?=?QPrinter.ScreenResolution) ``` 創建一個新的打印機對象與給定_mode_。 ``` QPrinter.__init__ (self, QPrinterInfo?printer, PrinterMode?mode?=?QPrinter.ScreenResolution) ``` 創建一個新的打印機對象與給定_printer_和_mode_。此功能被引入Qt的4.4 。 ``` bool QPrinter.abort (self) ``` 中止當前印數。返回True如果印數已成功中止，[printerState](qprinter.html#printerState)（）將返回[QPrinter.Aborted](qprinter.html#PrinterState-enum)否則返回False 。它并不總是可能中止打印作業。例如，所有的數據已經到打印機，但打印機不能或不愿當被問及取消作業。 ``` int QPrinter.actualNumCopies (self) ``` ``` bool QPrinter.collateCopies (self) ``` 如果核對開啟當選擇多個副本上，則返回True 。如果它被關閉，當選擇多個副本，則返回False 。當核對被關閉各個頁面的打印將被重復的[numCopies](index.htm#numCopies)（），開始下一個頁面之前量。隨著整理打開的所有網頁上這些網頁下副本開始前被打印出來。這個函數是Qt 4.1中引入。 **See also** [setCollateCopies](qprinter.html#setCollateCopies)（）。 ``` ColorMode QPrinter.colorMode (self) ``` [ 返回當前顏色模式。 ](qprinter.html#ColorMode-enum) [**See also**](qprinter.html#ColorMode-enum) [setColorMode](qprinter.html#setColorMode)（）。 ``` int QPrinter.copyCount (self) ``` 返回將要打印的份數。默認值是1。此功能被引入Qt的4.7 。 **See also** [setCopyCount](qprinter.html#setCopyCount)（）和[supportsMultipleCopies](qprinter.html#supportsMultipleCopies)（）。 ``` QString QPrinter.creator (self) ``` 返回創建文檔的應用程序的名稱。 **See also** [setCreator](qprinter.html#setCreator)（）。 ``` QString QPrinter.docName (self) ``` 返回的文檔名稱。 **See also** [setDocName](qprinter.html#setDocName)（）和[QPrintEngine.PrintEnginePropertyKey](qprintengine.html#PrintEnginePropertyKey-enum)。 ``` bool QPrinter.doubleSidedPrinting (self) ``` 如果雙面打印已啟用，則返回True 。目前這個選項只支持X11 。這個函數中引入了Qt 4.2中。 **See also** [setDoubleSidedPrinting](qprinter.html#setDoubleSidedPrinting)（）。 ``` DuplexMode QPrinter.duplex (self) ``` [ 返回當前的雙工模式。目前這個選項只支持X11 。此功能被引入Qt的4.4 。 ](qprinter.html#DuplexMode-enum) [**See also**](qprinter.html#DuplexMode-enum) [setDuplex](qprinter.html#setDuplex)（）。 ``` bool QPrinter.fontEmbeddingEnabled (self) ``` 如果字體嵌入已啟用，則返回True 。目前這個選項只支持X11 。這個函數是Qt 4.1中引入。 **See also** [setFontEmbeddingEnabled](qprinter.html#setFontEmbeddingEnabled)（）。 ``` int QPrinter.fromPage (self) ``` 返回第一頁的范圍為要打印的頁數（在“從頁”的設置）。在文檔中的頁面會根據第一頁第1頁慣例編號。默認情況下，此函數返回一個特殊值0 ，這意味著“從頁面”設置為no 。 **Note:**如果fromPage （）和[toPage](qprinter.html#toPage)（）都返回0 ，這表明_the whole document will be printed_。這個函數是Qt 4.1中引入。 **See also** [setFromTo](qprinter.html#setFromTo)（）和[toPage](qprinter.html#toPage)（）。 ``` bool QPrinter.fullPage (self) ``` 如果打印機的坐標系的原點位于頁面的角落，如果其為于可打印區域的邊緣，則返回True 。 See [setFullPage](qprinter.html#setFullPage)（）了解詳情和注意事項。 **See also** [setFullPage](qprinter.html#setFullPage)（）和[PaperSize](qprinter.html#PaperSize-enum)。 ``` (float?left, float?top, float?right, float?bottom) QPrinter.getPageMargins (self, Unit?unit) ``` 返回頁邊距為這臺打印機在_left_，_top_，_right_，_bottom_。返回的邊界的單元與指定_unit_參數。此功能被引入Qt的4.4 。 ``` bool QPrinter.isValid (self) ``` 返回True如果當前選擇的打印機是系統有效的打印機，或者一個純粹的PDF / PostScript打印機，否則返回False 。為了檢測其他故障檢查的輸出[QPainter.begin](qpainter.html#begin)（）或[QPrinter.newPage](qprinter.html#newPage)（）。 ``` [QPrinter](qprinter.html) printer; printer.setOutputFormat([QPrinter](qprinter.html).PdfFormat); printer.setOutputFileName("/foobar/nonwritable.pdf"); [QPainter](qpainter.html) painter; if (! painter.begin(&printer)) { // failed to open file qWarning("failed to open file, is it writable?"); return 1; } painter.drawText(10, 10, "Test"); if (! printer.newPage()) { qWarning("failed in flushing page to disk, disk full?"); return 1; } painter.drawText(10, 10, "Test 2"); painter.end(); ``` 此功能被引入Qt的4.4 。 **See also** [setPrinterName](qprinter.html#setPrinterName)（）。 ``` int QPrinter.metric (self, QPaintDevice.PaintDeviceMetric) ``` ``` bool QPrinter.newPage (self) ``` 告訴打印機退出當前頁面，并繼續打印在新頁面上。返回True如果成功，否則返回False 。在非活動呼叫NEWPAGE （）[QPrinter](qprinter.html)對象總是會失敗。 ``` int QPrinter.numCopies (self) ``` ``` Orientation QPrinter.orientation (self) ``` [](qprinter.html#Orientation-enum) [返回的方向設置。這是驅動程序相關的，但通常為](qprinter.html#Orientation-enum)[QPrinter.Portrait](qprinter.html#Orientation-enum)。 **See also** [setOrientation](qprinter.html#setOrientation)（）。 ``` QString QPrinter.outputFileName (self) ``` 返回的輸出文件的名稱。默認情況下，這是一個空字符串（表示打印機不能打印到文件）。 **See also** [setOutputFileName](qprinter.html#setOutputFileName)（）和[QPrintEngine.PrintEnginePropertyKey](qprintengine.html#PrintEnginePropertyKey-enum)。 ``` OutputFormat QPrinter.outputFormat (self) ``` [ 返回此打印機的輸出格式。這個函數是Qt 4.1中引入。 ](qprinter.html#OutputFormat-enum) [**See also**](qprinter.html#OutputFormat-enum) [setOutputFormat](qprinter.html#setOutputFormat)（）。 ``` PageOrder QPrinter.pageOrder (self) ``` [ 返回當前頁面順序。默認的頁面順序是`FirstPageFirst`。 ](qprinter.html#PageOrder-enum) [**See also**](qprinter.html#PageOrder-enum) [setPageOrder](qprinter.html#setPageOrder)（）。 ``` QRect QPrinter.pageRect (self) ``` [](qrect.html) [返回該頁面的矩形，這是通常比小](qrect.html)[paperRect](qprinter.html#paperRect)（），因為頁面通常具有其邊界和紙張之間的利潤率。返回的矩形的單元是[DevicePixel](qprinter.html#Unit-enum)。 **See also** [paperSize](qprinter.html#paperSize)（）。 ``` QRectF QPrinter.pageRect (self, Unit) ``` [](qrectf.html) [返回頁面的矩形_unit_;這通常比小](qrectf.html)[paperRect](qprinter.html#paperRect)（），因為頁面通常具有其邊界和紙張之間的利潤率。此功能被引入Qt的4.4 。 **See also** [paperSize](qprinter.html#paperSize)（）。 ``` PageSize QPrinter.pageSize (self) ``` [](qprinter.html#PageSize-enum) ``` QPaintEngine QPrinter.paintEngine (self) ``` [](qpaintengine.html) [從重新實現](qpaintengine.html)[QPaintDevice.paintEngine](qpaintdevice.html#paintEngine)（）。返回打印機使用的繪圖引擎。 ``` QRect QPrinter.paperRect (self) ``` [](qrect.html) [返回該紙的矩形，這是通常比大](qrect.html)[pageRect](qprinter.html#pageRect)（）。返回的矩形的單元是[DevicePixel](qprinter.html#Unit-enum)。 **See also** [pageRect](qprinter.html#pageRect)（）。 ``` QRectF QPrinter.paperRect (self, Unit) ``` [](qrectf.html) [返回該論文的矩形_unit_;這通常比大](qrectf.html)[pageRect](qprinter.html#pageRect)（）。此功能被引入Qt的4.4 。 **See also** [pageRect](qprinter.html#pageRect)（）。 ``` PageSize QPrinter.paperSize (self) ``` [ 返回打印機的紙張尺寸。默認值是驅動程序相關的。此功能被引入Qt的4.4 。 ](qprinter.html#PageSize-enum) [**See also**](qprinter.html#PageSize-enum) [setPaperSize](qprinter.html#setPaperSize)（）[pageRect](qprinter.html#pageRect)（）和[paperRect](qprinter.html#paperRect)（）。 ``` QSizeF QPrinter.paperSize (self, Unit?unit) ``` [ 返回的紙張尺寸_unit_。此功能被引入Qt的4.4 。 ](qsizef.html) [**See also**](qsizef.html) [setPaperSize](qprinter.html#setPaperSize)（）。 ``` PaperSource QPrinter.paperSource (self) ``` [ 返回打印機的紙張來源。這是`Manual`或打印機托盤或紙盒。 ](qprinter.html#PaperSource-enum) [**See also**](qprinter.html#PaperSource-enum) [setPaperSource](qprinter.html#setPaperSource)（）。 ``` QPrintEngine QPrinter.printEngine (self) ``` [ 返回所使用的打印機的打印引擎。這個函數是Qt 4.1中引入。 ``` QString QPrinter.printerName (self) ``` 返回打印機的名稱。這個值最初設置為默認打印機的名稱。 ](qprintengine.html) [**See also**](qprintengine.html) [setPrinterName](qprinter.html#setPrinterName)（）。 ``` QString QPrinter.printerSelectionOption (self) ``` 返回打印機選項選擇字符串。這是僅在打印命令已經明確設置非常有用。默認值（空字符串）意味著打印機應在與系統相關的方式來選擇。任何其他值意味著，給定的值應該被使用。 **Warning:**此功能不適用于Windows 。 **See also** [setPrinterSelectionOption](qprinter.html#setPrinterSelectionOption)（）。 ``` PrinterState QPrinter.printerState (self) ``` [ 返回打印機的當前狀態。這可能并不總是準確的（例如，如果打印機不具有報告其狀態的操作系統的能力）。 ``` QString QPrinter.printProgram (self) ``` 返回發送的打印輸出到打印機上的節目的名稱。 ](qprinter.html#PrinterState-enum) [默認是返回一個空字符串，這意味著](qprinter.html#PrinterState-enum)[QPrinter](qprinter.html)會自作聰明的系統相關的方式。在X11而已，你可以將它設置為不同的東西來使用特定的打印程序。在其他平臺上，此方法返回一個空字符串。 **See also** [setPrintProgram](qprinter.html#setPrintProgram)（）和[setPrinterSelectionOption](qprinter.html#setPrinterSelectionOption)（）。 ``` PrintRange QPrinter.printRange (self) ``` [](qprinter.html#PrintRange-enum) [返回的頁面范圍](qprinter.html#PrintRange-enum)[QPrinter](qprinter.html)。已經開通的打印設置對話框后，該函數返回用戶選擇的值。這個函數是Qt 4.1中引入。 **See also** [setPrintRange](qprinter.html#setPrintRange)（）。 ``` int QPrinter.resolution (self) ``` 返回打印機的當前假定號決議，載[setResolution](qprinter.html#setResolution)（）或由打印機驅動程序。 **See also** [setResolution](qprinter.html#setResolution)（）。 ``` QPrinter.setCollateCopies (self, bool?collate) ``` 設置了自動分頁復選框的默認值將出現打印對話框的時候。如果_collate_是真的，它將使[setCollateCopiesEnabled](index.htm#setCollateCopiesEnabled)（）。默認值是False 。此值將通過什么用戶按下在打印對話框中進行更改。這個函數是Qt 4.1中引入。 **See also** [collateCopies](qprinter.html#collateCopies)（）。 ``` QPrinter.setColorMode (self, ColorMode) ``` 設置打印機的色彩模式_newColorMode_，它可以是`Color` or `GrayScale`。 **See also** [colorMode](qprinter.html#colorMode)（）。 ``` QPrinter.setCopyCount (self, int) ``` 設置的份數被打印到_count_。打印機驅動程序讀取該設置并打印指定的副本數。此功能被引入Qt的4.7 。 **See also** [copyCount](qprinter.html#copyCount)（）和[supportsMultipleCopies](qprinter.html#supportsMultipleCopies)（）。 ``` QPrinter.setCreator (self, QString) ``` 設置創建該文件的應用程序的名稱_creator_。此功能僅適用于X11版本的Qt 。如果沒有指定創作者的名字，創作者將被設置為“ QT”后面跟著一些版本號。 **See also** [creator](qprinter.html#creator)（）。 ``` QPrinter.setDocName (self, QString) ``` 設置文件名_name_。在X11上，文件名稱是例如用作默認的輸出文件名[QPrintDialog](qprintdialog.html)。請注意，該文件的名稱不影響文件名如果打印機打印到文件。使用setOutputFile （）函數來實現這個。 **See also** [docName](qprinter.html#docName)（）和[QPrintEngine.PrintEnginePropertyKey](qprintengine.html#PrintEnginePropertyKey-enum)。 ``` QPrinter.setDoubleSidedPrinting (self, bool?enable) ``` 啟用雙面打印，如果_doubleSided_為True，否則禁用它。目前這個選項只支持X11 。這個函數中引入了Qt 4.2中。 **See also** [doubleSidedPrinting](qprinter.html#doubleSidedPrinting)（）。 ``` QPrinter.setDuplex (self, DuplexMode?duplex) ``` 啟用基于雙面打印_duplex_模式。目前這個選項只支持X11 。此功能被引入Qt的4.4 。 **See also** [duplex](qprinter.html#duplex)（）。 ``` QPrinter.setEngines (self, QPrintEngine?printEngine, QPaintEngine?paintEngine) ``` 此功能用于通過子類[QPrinter](qprinter.html)指定自定義打印和油漆引擎（_printEngine_和_paintEngine_，分別）。 [QPrinter](qprinter.html)不佔用發動機的所有權，所以你需要管理這些引擎的情況下自己。請注意，改變發動機將重置打印機的狀態和它的所有屬性。這個函數是Qt 4.1中引入。 **See also** [printEngine](qprinter.html#printEngine)（）[paintEngine](qprinter.html#paintEngine)（）和[setOutputFormat](qprinter.html#setOutputFormat)（）。 ``` QPrinter.setFontEmbeddingEnabled (self, bool?enable) ``` 啟用或禁用字體嵌入視_enable_。目前這個選項只支持X11 。這個函數是Qt 4.1中引入。 **See also** [fontEmbeddingEnabled](qprinter.html#fontEmbeddingEnabled)（）。 ``` QPrinter.setFromTo (self, int?fromPage, int?toPage) ``` 設置的要打印到復蓋由指定號碼的頁面的頁面范圍_from_和_to_，其中_from_對應于該區域中的第一頁和_to_對應于最后。 **Note:**在文檔中的頁面會根據第一頁第1頁慣例編號。然而，如果_from_和_to_都設置為0，則_whole document will be printed_。此功能主要用于當你調用設置一個默認值，用戶可以復蓋在打印對話框[setup](index.htm#setup)（）。這個函數是Qt 4.1中引入。 **See also** [fromPage](qprinter.html#fromPage)（）和[toPage](qprinter.html#toPage)（）。 ``` QPrinter.setFullPage (self, bool) ``` If _fp_誠然，使繪畫在整個頁面的支持，否則將繪制限制在設備報告的可打印區域。默認情況下，滿頁打印被禁用。在這種情況下，在原點[QPrinter](qprinter.html)的坐標系可打印區域的左上角重合。如果整頁打印啟用時，的起源[QPrinter](qprinter.html)的坐標系統與紙本身的左上角重合。在這種情況下，[device metrics](qpaintdevice.html#PaintDeviceMetric-enum)由所指示將報告完全相同的尺寸[PaperSize](qprinter.html#PaperSize-enum)。它可能無法在整個物理頁的打印，因為打印機的頁邊距的，因此應用程序必須考慮邊緣本身。 **See also** [fullPage](qprinter.html#fullPage)（）[setPaperSize](qprinter.html#setPaperSize)（）[width](qpaintdevice.html#width)（）[height](qpaintdevice.html#height)（）和[Printing with Qt](index.htm)。 ``` QPrinter.setNumCopies (self, int) ``` ``` QPrinter.setOrientation (self, Orientation) ``` 設置打印方向為_orientation_。方向既可以是[QPrinter.Portrait](qprinter.html#Orientation-enum) or [QPrinter.Landscape](qprinter.html#Orientation-enum)。打印機驅動程序讀取使用指定的方向該設置并打印。在Windows上，可以在打印時更改此選項，將生效從下一次調用[newPage](qprinter.html#newPage)（）。在Mac OS X ，在打印作業期間改變方向沒有影響。 **See also** [orientation](qprinter.html#orientation)（）。 ``` QPrinter.setOutputFileName (self, QString) ``` 設置輸出文件的名稱_fileName_。設置為null或空名稱（ 0或“” ）禁用打印到文件。設置一個非空的名字使打印到文件中。這可以改變的值[outputFormat](qprinter.html#outputFormat)（）。如果文件名的后綴“ 。 PS”的PostScript ，然后自動選擇輸出格式。如果文件名有“ PDF ”后綴的PDF生成。如果文件名有一個后綴不是“ PS”和“ PDF ”等，所使用的輸出格式是一組與[setOutputFormat](qprinter.html#setOutputFormat)（）。 [QPrinter](qprinter.html)使用Qt的跨平臺的PostScript或PDF打印引擎分別。如果你可以在本地生產這種格式，例如Mac OS X可以從它的打印引擎生成PDF文件，設置輸出格式返回給[NativeFormat](qprinter.html#OutputFormat-enum)。 **See also** [outputFileName](qprinter.html#outputFileName)（）[setOutputToFile](index.htm#setOutputToFile)（）和[setOutputFormat](qprinter.html#setOutputFormat)（）。 ``` QPrinter.setOutputFormat (self, OutputFormat?format) ``` 設置該打印機的輸出格式_format_。這個函數是Qt 4.1中引入。 **See also** [outputFormat](qprinter.html#outputFormat)（）。 ``` QPrinter.setPageMargins (self, float?left, float?top, float?right, float?bottom, Unit?unit) ``` 該函數設置_left_，_top_，_right_和_bottom_頁邊距為這臺打印機。頁邊距的單位與指定_unit_參數。此功能被引入Qt的4.4 。 ``` QPrinter.setPageOrder (self, PageOrder) ``` 設置頁面順序來_pageOrder_。頁面順序可以是[QPrinter.FirstPageFirst](qprinter.html#PageOrder-enum) or [QPrinter.LastPageFirst](qprinter.html#PageOrder-enum)。該應用程序是負責讀取頁面順序和相應的打印。此功能是設置一個默認值，用戶可以在打印對話框中復蓋最有用。此功能僅在X11下的支持。 **See also** [pageOrder](qprinter.html#pageOrder)（）。 ``` QPrinter.setPageSize (self, PageSize) ``` ``` QPrinter.setPaperSize (self, PageSize) ``` 設置打印機紙張大小_newPaperSize_如果支持的大小。其結果是不確定的，如果_newPaperSize_不被支持。默認的紙張大小是取決于驅動程序。此功能主要是用于設置一個默認值，用戶可以在打印對話框中重寫有用的。此功能被引入Qt的4.4 。 **See also** [paperSize](qprinter.html#paperSize)（）[PaperSize](qprinter.html#PaperSize-enum)，[setFullPage](qprinter.html#setFullPage)（）[setResolution](qprinter.html#setResolution)（）[pageRect](qprinter.html#pageRect)（）和[paperRect](qprinter.html#paperRect)（）。 ``` QPrinter.setPaperSize (self, QSizeF?paperSize, Unit?unit) ``` 設置紙張尺寸的基礎上_paperSize_在_unit_。此功能被引入Qt的4.4 。 **See also** [paperSize](qprinter.html#paperSize)（）。 ``` QPrinter.setPaperSource (self, PaperSource) ``` 設置紙張來源設置為_source_。僅適用于Windows ：該選項可以在打印時改變將生效從下一次調用[newPage](qprinter.html#newPage)（） **See also** [paperSource](qprinter.html#paperSource)（）。 ``` QPrinter.setPrinterName (self, QString) ``` 設置打印機名稱_name_。 **See also** [printerName](qprinter.html#printerName)（）和[isValid](qprinter.html#isValid)（）。 ``` QPrinter.setPrinterSelectionOption (self, QString) ``` 設置要使用的打印機_option_選擇打印機。_option_為null （默認情況下這意味著Qt的應該是足夠聰明，猜對），但它可以被設置為其他值使用特定的打印機選擇選項。如果選擇打印機選項被改變，而在打印機處于活動狀態，當前打印作業可能會或可能不會受到影響。 **Warning:**此功能不適用于Windows 。 **See also** [printerSelectionOption](qprinter.html#printerSelectionOption)（）。 ``` QPrinter.setPrintProgram (self, QString) ``` 設置應該做的打印作業的程序的名稱_printProg_。在X11上，此功能將設置程序與PostScript輸出打電話。在其他平臺上，它沒有任何效果。 **See also** [printProgram](qprinter.html#printProgram)（）。 ``` QPrinter.setPrintRange (self, PrintRange?range) ``` 設置打印范圍選項是_range_。這個函數是Qt 4.1中引入。 **See also** [printRange](qprinter.html#printRange)（）。 ``` QPrinter.setResolution (self, int) ``` 要求打印機在打印_dpi_或在靠近_dpi_越好。所返回該設置影響的坐標系統，例如[QPainter.viewport](qpainter.html#viewport)（）。這個函數必須在被調用[QPainter.begin](qpainter.html#begin)（）有在所有平臺上的效果。 **See also** [resolution](qprinter.html#resolution)（）和[setPaperSize](qprinter.html#setPaperSize)（）。 ``` list-of-int QPrinter.supportedResolutions (self) ``` 返回的決議（的點每英寸的整數的列表）清單打印機說它支持。對于X11 ，所有的印刷是直接到后記，這個函數總是返回一個僅包含后記分辨率，即72 （ 72 dpi的一個項目列表 - 但見[PrinterMode](qprinter.html#PrinterMode-enum)）。 ``` bool QPrinter.supportsMultipleCopies (self) ``` 返回True如果打印機支持打印在一個作業中的同一文檔的多個副本，否則返回False。在大多數系統中，這個函數將返回True 。但是，不支持CUPS的X11系統上，這個函數將返回False 。這意味著應用程序具有通過打印同一文檔的要求的次數來處理的份數。此功能被引入Qt的4.7 。 **See also** [setCopyCount](qprinter.html#setCopyCount)（）和[copyCount](qprinter.html#copyCount)（）。 ``` int QPrinter.toPage (self) ``` 返回的最后一頁，在一定范圍內的要打印的頁數（在“頁面”的設置）。在文檔中的頁面會根據第一頁第1頁慣例編號。默認情況下，此函數返回一個特殊值0 ，意思是“頁面”設置為no 。 **Note:** If [fromPage](qprinter.html#fromPage)（）和toPage （）都返回0 ，這表明_the whole document will be printed_。程序員負責讀取該設置并打印相應。這個函數是Qt 4.1中引入。 **See also** [setFromTo](qprinter.html#setFromTo)（）和[fromPage](qprinter.html#fromPage)（）。