Home · All Classes · Modules · QSS HELP · QSS 案例 · VER007 HOME |
该QPrinter做类是涂料设备,油漆上的打印机。More...
继承QPaintDevice。
该QPrinter做类是涂料设备,油漆上的打印机。
这个设备代表了一系列的打印输出页,并且被用在几乎完全一样的方式与其他涂料设备,如QWidget和QPixmap。提供一组额外的功能来管理设备特定的功能,如方向和分辨率,并逐步在文档中的页面,因为它是生成的。
直接打印在Windows或Mac OS X的打印机时, QPrinter则负责使用内置的打印机驱动程序。在X11上, QPrinter则负责使用Common Unix Printing System (CUPS)或标准Unixlpr实用派的PostScript或PDF输出到打印机。作为替代,本printProgram( )函数可以用来指定命令或工具来使用,而不是系统默认的。
请注意,如纸张尺寸和分辨率上的一个无效的打印机设置参数是不确定的。您可以使用QPrinter.isValid()来更改任何参数之前验证这一点。
QPrinter做支持多个参数,其中大部分可以通过一个最终用户来改变print dialog。在一般情况下, QPrinter做通过这些功能到底层QPrintEngine。
最重要的参数是:
实际印刷开始之前许多这些功能只能叫(即前QPainter.begin( )被调用) 。这通常是有道理的,因为,例如,它是不可能的,当你中途印刷改变的份数。也有一些用户设置(通过打印机对话框),并且应用程序都应该遵守的一些设置。看QAbstractPrintDialog的文档了解更多信息。
When QPainter.begin()被调用时,它运行在QPrinter做准备一个新的页面,从而使QPainter要立即用于油漆中的第一页的文档。一旦第一个页面已经被画,newPage( )可以调用请求一个新的空白页面上绘制,或QPainter.end( )可以被调用来完成打印。第二页和之后的所有页面都通过调用准备newPage( )它们都画前。
在文档的第一页也不需要在前面加上一个呼叫到newPage( ) 。你只需要调用newPage( )后QPainter.begin( )如果你需要打印的文档的开头插入一个空白页。同样,调用newPage()中的文件的最后一页被涂之后,将导致附加到印刷文件的末尾的后空白页。
如果你想中止打印作业,abort( )将尽最大努力停止打印。它可能会取消整个作业或只是其中的一部分。
由于QPrinter做可以打印到任何QPrintEngine子类,它可以扩展打印支持通过子类化,以包括新类型的印刷子系统QPrintEngine并重新实现它的接口。
该枚举类型用于指示是否QPrinter应该在颜色或不打印。
Constant | Value | Description |
---|---|---|
QPrinter.Color | 1 | 彩色打印如果可用,否则是灰色的。 |
QPrinter.GrayScale | 0 | 灰度打印,即使在彩色打印机。 |
该枚举用于指示是否将发生在纸(单面或双面印刷),每个片材的一侧或两侧上印刷。
Constant | Value | Description |
---|---|---|
QPrinter.DuplexNone | 0 | 单面(单面)打印只。 |
QPrinter.DuplexAuto | 1 | 打印机的默认设置是用来判断双面打印是否被使用。 |
QPrinter.DuplexLongSide | 2 | 每张纸的两面都用于印刷。将纸张翻过来的最长边的第二面打印之前 |
QPrinter.DuplexShortSide | 3 | 每张纸的两面都用于印刷。将纸张翻过来的最短边的第二面打印之前 |
这个枚举被引入或修改的Qt 4.4 。
该枚举类型(不要与混淆Orientation)被用来指定每个页面的方向。
Constant | Value | Description |
---|---|---|
QPrinter.Portrait | 0 | 页面的高度大于它的宽度。 |
QPrinter.Landscape | 1 | 该页面的宽度大于它的高度。 |
这种类型的交互QPrinter.PaperSize和QPrinter.setFullPage()来判断页面的最终尺寸提供给应用程序。
的OutputFormat枚举用于描述的格式QPrinter应该使用进行打印。
Constant | Value | Description |
---|---|---|
QPrinter.NativeFormat | 0 | QPrinter将使用由它运行的平台定义的方法打印输出。这种模式是默认的直接打印到打印机时。 |
QPrinter.PdfFormat | 1 | QPrinter会产生它的输出作为一个可搜索的PDF文件。这种模式是默认的打印到文件时。 |
QPrinter.PostScriptFormat | 2 | QPrinter将产生其输出作为在PostScript格式。 (此功能被引入的Qt 4.2 。 ) |
See also outputFormat( )setOutputFormat()和setOutputFileName( ) 。
该枚举类型用于通过QPrinter告诉应用程序如何打印。
Constant | Value | Description |
---|---|---|
QPrinter.FirstPageFirst | 0 | 编号最小的页面应该先打印出来。 |
QPrinter.LastPageFirst | 1 | 最高编号的页面应该先打印出来。 |
该枚举类型指定了纸张来源QPrinter是使用。QPrinter不检查纸张来源是否可用;它只是使用这些信息来尝试并设置纸张来源。它是否将设置纸张来源取决于打印机是否具有特定源。
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 |
这个枚举变量描述模式的打印机应该工作。它基本上是预置了一定的分辨率和工作模式。
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装置中,要认识到,文字的大小,当在指定的点,是独立于装置本身所指定的分辨率是重要的。因此,它可能是有用的,当结合文字与图形,以确保它们的相对大小是您所期望的指定以像素为单位的字体大小。
Constant | Value |
---|---|
QPrinter.Idle | 0 |
QPrinter.Active | 1 |
QPrinter.Aborted | 2 |
QPrinter.Error | 3 |
用于指定打印范围选择选项。
Constant | Value | Description |
---|---|---|
QPrinter.AllPages | 0 | 所有网页应打印。 |
QPrinter.Selection | 1 | 唯一的选择应打印。 |
QPrinter.PageRange | 2 | 指定页面范围应打印。 |
QPrinter.CurrentPage | 3 | 只有当前页面应该被打印出来。 |
See also QAbstractPrintDialog.PrintRange。
该枚举类型用于指定的测量单位为页和纸张尺寸。
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 。
创建一个新的打印机对象与给定mode。
创建一个新的打印机对象与给定printer和mode。
此功能被引入Qt的4.4 。
中止当前印数。返回True如果印数已成功中止,printerState( )将返回QPrinter.Aborted否则返回False 。
它并不总是可能中止打印作业。例如,所有的数据已经到打印机,但打印机不能或不愿当被问及取消作业。
如果核对开启当选择多个副本上,则返回True 。如果它被关闭,当选择多个副本,则返回False 。当核对被关闭各个页面的打印将被重复的numCopies( ) ,开始下一个页面之前量。随着整理打开的所有网页上这些网页下副本开始前被打印出来。
这个函数是Qt 4.1中引入。
See also setCollateCopies( ) 。
返回当前颜色模式。
See also setColorMode( ) 。
返回将要打印的份数。默认值是1。
此功能被引入Qt的4.7 。
See also setCopyCount()和supportsMultipleCopies( ) 。
返回创建文档的应用程序的名称。
See also setCreator( ) 。
返回的文档名称。
See also setDocName()和QPrintEngine.PrintEnginePropertyKey。
如果双面打印已启用,则返回True 。
目前这个选项只支持X11 。
这个函数中引入了Qt 4.2中。
See also setDoubleSidedPrinting( ) 。
返回当前的双工模式。
目前这个选项只支持X11 。
此功能被引入Qt的4.4 。
See also setDuplex( ) 。
如果字体嵌入已启用,则返回True 。
目前这个选项只支持X11 。
这个函数是Qt 4.1中引入。
See also setFontEmbeddingEnabled( ) 。
返回第一页的范围为要打印的页数(在“从页”的设置) 。在文档中的页面会根据第一页第1页惯例编号。
默认情况下,此函数返回一个特殊值0 ,这意味着“从页面”设置为no 。
Note:如果fromPage ()和toPage( )都返回0 ,这表明the whole document will be printed。
这个函数是Qt 4.1中引入。
See also setFromTo()和toPage( ) 。
如果打印机的坐标系的原点位于页面的角落,如果其为于可打印区域的边缘,则返回True 。
See setFullPage( )了解详情和注意事项。
See also setFullPage()和PaperSize。
返回页边距为这台打印机在left,top,right,bottom。返回的边界的单元与指定unit参数。
此功能被引入Qt的4.4 。
返回True如果当前选择的打印机是系统有效的打印机,或者一个纯粹的PDF / PostScript打印机,否则返回False 。
为了检测其他故障检查的输出QPainter.begin()或QPrinter.newPage( ) 。
QPrinter printer; printer.setOutputFormat(QPrinter.PdfFormat); printer.setOutputFileName("/foobar/nonwritable.pdf"); QPainter 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( ) 。
告诉打印机退出当前页面,并继续打印在新页面上。返回True如果成功,否则返回False 。
在非活动呼叫NEWPAGE ( )QPrinter对象总是会失败。
返回的方向设置。这是驱动程序相关的,但通常为QPrinter.Portrait。
See also setOrientation( ) 。
返回的输出文件的名称。默认情况下,这是一个空字符串(表示打印机不能打印到文件) 。
See also setOutputFileName()和QPrintEngine.PrintEnginePropertyKey。
返回此打印机的输出格式。
这个函数是Qt 4.1中引入。
See also setOutputFormat( ) 。
返回当前页面顺序。
默认的页面顺序是FirstPageFirst。
See also setPageOrder( ) 。
返回该页面的矩形,这是通常比小paperRect( ),因为页面通常具有其边界和纸张之间的利润率。
返回的矩形的单元是DevicePixel。
See also paperSize( ) 。
返回页面的矩形unit;这通常比小paperRect( ),因为页面通常具有其边界和纸张之间的利润率。
此功能被引入Qt的4.4 。
See also paperSize( ) 。
从重新实现QPaintDevice.paintEngine( ) 。
返回打印机使用的绘图引擎。
返回该纸的矩形,这是通常比大pageRect( ) 。
返回的矩形的单元是DevicePixel。
See also pageRect( ) 。
返回该论文的矩形unit;这通常比大pageRect( ) 。
此功能被引入Qt的4.4 。
See also pageRect( ) 。
返回打印机的纸张尺寸。默认值是驱动程序相关的。
此功能被引入Qt的4.4 。
See also setPaperSize( )pageRect()和paperRect( ) 。
返回的纸张尺寸unit。
此功能被引入Qt的4.4 。
See also setPaperSize( ) 。
返回打印机的纸张来源。这是Manual或打印机托盘或纸盒。
See also setPaperSource( ) 。
返回所使用的打印机的打印引擎。
这个函数是Qt 4.1中引入。
返回打印机的名称。这个值最初设置为默认打印机的名称。
See also setPrinterName( ) 。
返回打印机选项选择字符串。这是仅在打印命令已经明确设置非常有用。
默认值(空字符串)意味着打印机应在与系统相关的方式来选择。
任何其他值意味着,给定的值应该被使用。
Warning:此功能不适用于Windows 。
See also setPrinterSelectionOption( ) 。
返回打印机的当前状态。这可能并不总是准确的(例如,如果打印机不具有报告其状态的操作系统的能力) 。
返回发送的打印输出到打印机上的节目的名称。
默认是返回一个空字符串,这意味着QPrinter会自作聪明的系统相关的方式。在X11而已,你可以将它设置为不同的东西来使用特定的打印程序。在其他平台上,此方法返回一个空字符串。
See also setPrintProgram()和setPrinterSelectionOption( ) 。
返回的页面范围QPrinter。已经开通的打印设置对话框后,该函数返回用户选择的值。
这个函数是Qt 4.1中引入。
See also setPrintRange( ) 。
返回打印机的当前假定号决议,载setResolution()或由打印机驱动程序。
See also setResolution( ) 。
设置了自动分页复选框的默认值将出现打印对话框的时候。如果collate是真的,它将使setCollateCopiesEnabled( ) 。默认值是False 。此值将通过什么用户按下在打印对话框中进行更改。
这个函数是Qt 4.1中引入。
See also collateCopies( ) 。
设置打印机的色彩模式newColorMode,它可以是Color or GrayScale。
See also colorMode( ) 。
设置的份数被打印到count。
打印机驱动程序读取该设置并打印指定的副本数。
此功能被引入Qt的4.7 。
See also copyCount()和supportsMultipleCopies( ) 。
设置创建该文件的应用程序的名称creator。
此功能仅适用于X11版本的Qt 。如果没有指定创作者的名字,创作者将被设置为“ QT”后面跟着一些版本号。
See also creator( ) 。
设置文件名name。
在X11上,文件名称是例如用作默认的输出文件名QPrintDialog。请注意,该文件的名称不影响文件名如果打印机打印到文件。使用setOutputFile ()函数来实现这个。
See also docName()和QPrintEngine.PrintEnginePropertyKey。
启用双面打印,如果doubleSided为True,否则禁用它。
目前这个选项只支持X11 。
这个函数中引入了Qt 4.2中。
See also doubleSidedPrinting( ) 。
启用基于双面打印duplex模式。
目前这个选项只支持X11 。
此功能被引入Qt的4.4 。
See also duplex( ) 。
此功能用于通过子类QPrinter指定自定义打印和油漆引擎(printEngine和paintEngine,分别)。
QPrinter不佔用发动机的所有权,所以你需要管理这些引擎的情况下自己。
请注意,改变发动机将重置打印机的状态和它的所有属性。
这个函数是Qt 4.1中引入。
See also printEngine( )paintEngine()和setOutputFormat( ) 。
启用或禁用字体嵌入视enable。
目前这个选项只支持X11 。
这个函数是Qt 4.1中引入。
See also fontEmbeddingEnabled( ) 。
设置的要打印到复盖由指定号码的页面的页面范围from和to,其中from对应于该区域中的第一页和to对应于最后。
Note:在文档中的页面会根据第一页第1页惯例编号。然而,如果from和to都设置为0,则whole document will be printed。
此功能主要用于当你调用设置一个默认值,用户可以复盖在打印对话框setup( ) 。
这个函数是Qt 4.1中引入。
See also fromPage()和toPage( ) 。
If fp诚然,使绘画在整个页面的支持,否则将绘制限制在设备报告的可打印区域。
默认情况下,满页打印被禁用。在这种情况下,在原点QPrinter的坐标系可打印区域的左上角重合。
如果整页打印启用时,的起源QPrinter的坐标系统与纸本身的左上角重合。在这种情况下,device metrics由所指示将报告完全相同的尺寸PaperSize。它可能无法在整个物理页的打印,因为打印机的页边距的,因此应用程序必须考虑边缘本身。
See also fullPage( )setPaperSize( )width( )height()和Printing with Qt。
设置打印方向为orientation。
方向既可以是QPrinter.Portrait or QPrinter.Landscape。
打印机驱动程序读取使用指定的方向该设置并打印。
在Windows上,可以在打印时更改此选项,将生效从下一次调用newPage( ) 。
在Mac OS X ,在打印作业期间改变方向没有影响。
See also orientation( ) 。
设置输出文件的名称fileName。
设置为null或空名称( 0或“” )禁用打印到文件。设置一个非空的名字使打印到文件中。
这可以改变的值outputFormat( ) 。如果文件名的后缀“ 。 PS”的PostScript ,然后自动选择输出格式。如果文件名有“ PDF ”后缀的PDF生成。如果文件名有一个后缀不是“ PS”和“ PDF ”等,所使用的输出格式是一组与setOutputFormat( ) 。
QPrinter使用Qt的跨平台的PostScript或PDF打印引擎分别。如果你可以在本地生产这种格式,例如Mac OS X可以从它的打印引擎生成PDF文件,设置输出格式返回给NativeFormat。
See also outputFileName( )setOutputToFile()和setOutputFormat( ) 。
设置该打印机的输出格式format。
这个函数是Qt 4.1中引入。
See also outputFormat( ) 。
该函数设置left,top,right和bottom页边距为这台打印机。页边距的单位与指定unit参数。
此功能被引入Qt的4.4 。
设置页面顺序来pageOrder。
页面顺序可以是QPrinter.FirstPageFirst or QPrinter.LastPageFirst。该应用程序是负责读取页面顺序和相应的打印。
此功能是设置一个默认值,用户可以在打印对话框中复盖最有用。
此功能仅在X11下的支持。
See also pageOrder( ) 。
设置打印机纸张大小newPaperSize如果支持的大小。其结果是不确定的,如果newPaperSize不被支持。
默认的纸张大小是取决于驱动程序。
此功能主要是用于设置一个默认值,用户可以在打印对话框中重写有用的。
此功能被引入Qt的4.4 。
See also paperSize( )PaperSize,setFullPage( )setResolution( )pageRect()和paperRect( ) 。
设置纸张尺寸的基础上paperSize在unit。
此功能被引入Qt的4.4 。
See also paperSize( ) 。
设置纸张来源设置为source。
仅适用于Windows :该选项可以在打印时改变将生效从下一次调用newPage( )
See also paperSource( ) 。
设置打印机名称name。
See also printerName()和isValid( ) 。
设置要使用的打印机option选择打印机。option为null (默认情况下这意味着Qt的应该是足够聪明,猜对),但它可以被设置为其他值使用特定的打印机选择选项。
如果选择打印机选项被改变,而在打印机处于活动状态,当前打印作业可能会或可能不会受到影响。
Warning:此功能不适用于Windows 。
See also printerSelectionOption( ) 。
设置应该做的打印作业的程序的名称printProg。
在X11上,此功能将设置程序与PostScript输出打电话。在其他平台上,它没有任何效果。
See also printProgram( ) 。
设置打印范围选项是range。
这个函数是Qt 4.1中引入。
See also printRange( ) 。
要求打印机在打印dpi或在靠近dpi越好。
所返回该设置影响的坐标系统,例如QPainter.viewport( ) 。
这个函数必须在被调用QPainter.begin( )有在所有平台上的效果。
See also resolution()和setPaperSize( ) 。
返回的决议(的点每英寸的整数的列表)清单打印机说它支持。
对于X11 ,所有的印刷是直接到后记,这个函数总是返回一个仅包含后记分辨率,即72 ( 72 dpi的一个项目列表 - 但见PrinterMode) 。
返回True如果打印机支持打印在一个作业中的同一文档的多个副本,否则返回False。
在大多数系统中,这个函数将返回True 。但是,不支持CUPS的X11系统上,这个函数将返回False 。这意味着应用程序具有通过打印同一文档的要求的次数来处理的份数。
此功能被引入Qt的4.7 。
See also setCopyCount()和copyCount( ) 。
返回的最后一页,在一定范围内的要打印的页数(在“页面”的设置) 。在文档中的页面会根据第一页第1页惯例编号。
默认情况下,此函数返回一个特殊值0 ,意思是“页面”设置为no 。
Note: If fromPage()和toPage ()都返回0 ,这表明the whole document will be printed。
程序员负责读取该设置并打印相应。
这个函数是Qt 4.1中引入。
See also setFromTo()和fromPage( ) 。
PyQt 4.10.3 for X11 | Copyright © Riverbank Computing Ltd and Nokia 2012 | Qt 4.8.5 |