PrinterJob (Java Platform SE 8 )

java.lang.Object
- java.awt.print.PrinterJob

```
public abstract class PrinterJob
extends Object
```
的 PrinterJob类是主类，控制打印。一个应用程序调用这个类中的方法来设置一个作业，可以选择地调用一个与用户的打印对话框，然后打印作业的页面。

构造方法摘要

构造方法
Constructor and Description
`PrinterJob()` 一个 `PrinterJob`对象应使用静态方法创建的 `getPrinterJob`。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract void`	`cancel()` 取消正在进行的打印作业。
`PageFormat`	`defaultPage()` 创建一个新的 `PageFormat`实例并将其设置为默认的大小和方向。
`abstract PageFormat`	`defaultPage(PageFormat page)` 克隆 `PageFormat`争论和改变克隆来描述一个默认的页面大小和方向。
`abstract int`	`getCopies()` 获取要打印的副本的数量。
`abstract String`	`getJobName()` 获取要打印的文档的名称。
`PageFormat`	`getPageFormat(PrintRequestAttributeSet attributes)` 计算值一致的电流 `PrintService`支持这项工作 `PageFormat`（即返回的值 `getPrintService()`）和媒体，可打印区域定位包含在 `attributes`。
`static PrinterJob`	`getPrinterJob()` 创建并返回一个 `PrinterJob`最初是用默认的打印机相关联的。
`PrintService`	`getPrintService()` 返回此打印机作业的服务（打印机）。
`abstract String`	`getUserName()` 获取打印用户的名称。
`abstract boolean`	`isCancelled()` 返回 `true`如果打印作业正在进行中，但会在下次有机会取消；否则返回 `false`。
`static PrintService[]`	`lookupPrintServices()` 一种方便的方法，它查找二维打印服务。
`static StreamPrintServiceFactory[]`	`lookupStreamPrintServices(String mimeType)` 一种方便的方法，它位于工厂的流打印服务，可以图像二维图形。
`abstract PageFormat`	`pageDialog(PageFormat page)` 显示一个对话框，允许一个 `PageFormat`实例修改。
`PageFormat`	`pageDialog(PrintRequestAttributeSet attributes)` 一种方便的方法，它显示一个跨平台的页面设置对话框。
`abstract void`	`print()` 打印一组页。
`void`	`print(PrintRequestAttributeSet attributes)` 在属性集的设置中打印一组页。
`abstract boolean`	`printDialog()` 向用户提供一个对话框，用于更改打印作业的属性。
`boolean`	`printDialog(PrintRequestAttributeSet attributes)` 一个方便的方法，显示了一个跨平台的打印对话框的所有服务都能够使用 `Pageable`印刷二维图形界面。
`abstract void`	`setCopies(int copies)` 设置要打印的副本的数量。
`abstract void`	`setJobName(String jobName)` 设置要打印的文档的名称。
`abstract void`	`setPageable(Pageable document)` 查询 `document`为页的数量和 `PageFormat`和 `Printable`每个页面中的 `Pageable`实例举行， `document`。
`abstract void`	`setPrintable(Printable painter)` 电话 `painter`渲染页面。
`abstract void`	`setPrintable(Printable painter, PageFormat format)` 电话 `painter`绘制指定的 `format`页。
`void`	`setPrintService(PrintService service)` 这一新的打字printerjob副。
`abstract PageFormat`	`validatePage(PageFormat page)` 返回它的设置调整为与本 `PrinterJob`当前打印机兼容 `page`克隆。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - PrinterJob
```
public PrinterJob()
```
    一个 PrinterJob对象应使用静态方法创建的 getPrinterJob。
- 方法详细信息
  - getPrinterJob
```
public static PrinterJob getPrinterJob()
```
    创建并返回一个 PrinterJob最初是用默认的打印机相关联的。如果没有打印机可在系统上，一个printerjob仍将从这个方法返回，但 getPrintService()将返回 null，叫 print这个 PrinterJob可能产生异常。要确定是否有合适的打印机之前创建一个 PrinterJob应该确保从 lookupPrintServices返回的数组是空的应用。
    
    结果
    
    一个新的 PrinterJob。
    
    异常
    
    SecurityException -如果存在一个安全管理及其 SecurityManager.checkPrintJobAccess()方法不允许该线程创建一个打印作业要求
  - lookupPrintServices
```
public static PrintService[] lookupPrintServices()
```
    一种方便的方法，它查找二维打印服务。服务从这个方法返回可安装在 PrinterJobs支持打印服务。调用此方法相当于调用 PrintServiceLookup.lookupPrintServices()和指定Pageable DocFlavor。
    
    结果
    
    一个可能是空数组的二维打印服务。
    
    从以下版本开始：
    
    一点四
  - lookupStreamPrintServices
```
public static StreamPrintServiceFactory[] lookupStreamPrintServices(String mimeType)
```
    一种方便的方法，它位于工厂的流打印服务，可以图像二维图形。示例用法：
```
 FileOutputStream outstream;
 StreamPrintService psPrinter;
 String psMimeType = "application/postscript";
 PrinterJob pj = PrinterJob.getPrinterJob();

 StreamPrintServiceFactory[] factories =
     PrinterJob.lookupStreamPrintServices(psMimeType);
 if (factories.length > 0) {
     try {
         outstream = new File("out.ps");
         psPrinter =  factories[0].getPrintService(outstream);
         // psPrinter can now be set as the service on a PrinterJob
         pj.setPrintService(psPrinter)
     } catch (Exception e) {
         e.printStackTrace();
     }
 }
 
```
    服务从该方法返回的实例，可以安装在 PrinterJob支持打印服务。调用此方法相当于调用 StreamPrintServiceFactory.lookupStreamPrintServiceFactories() 和指定Pageable DocFlavor。
    参数
    
    mimeType -所需的输出格式，或零意味着任何格式。
    
    结果
    
    一个可能是空的二维流打印服务工厂阵列。
    
    从以下版本开始：
    
    一点四
  - getPrintService
```
public PrintService getPrintService()
```
    返回此打印机作业的服务（打印机）。此类不支持打印服务的实现可能返回空值。如果没有可用的打印机，也将返回空值。
    
    结果
    
    此打印机作业的服务。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    setPrintService(PrintService)， getPrinterJob()
  - setPrintService
```
public void setPrintService(PrintService service)
                     throws PrinterException
```
    这一新的打字printerjob副。这种方法是通过子类重写，支持指定打印服务。把 PrinterException如果不能指定的服务支持 Pageable和 Printable接口必须支持2D打印。
    
    参数
    
    service -支持2D打印打印服务
    
    异常
    
    PrinterException -如果指定的服务不支持2D打印，或这printerjob类不支持设置二维打印服务，或指定的服务，否则无效的打印服务。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    getPrintService()
  - setPrintable
```
public abstract void setPrintable(Printable painter)
```
    电话 painter渲染页面。在文档的页面被这 PrinterJob印刷的 Printable对象的呈现， painter。每一页的 PageFormat是默认的页面格式。
    
    参数
    
    painter - Printable使文档的每一页。
  - setPrintable
```
public abstract void setPrintable(Printable painter,
                                  PageFormat format)
```
    电话 painter绘制指定的 format页。在文档的页面被这 PrinterJob印刷的 Printable对象，呈现 painter。每一页的 PageFormat是 format。
    
    参数
    
    painter - Printable称为文档的每一页
    
    format -每个页面的大小和方向是印刷
  - setPageable
```
public abstract void setPageable(Pageable document)
                          throws NullPointerException
```
    查询 document为页的数量和 PageFormat和 Printable每个页面中的 Pageable实例举行， document。
    
    参数
    
    document -要打印的页。它不能 null。
    
    异常
    
    NullPointerException - Pageable传入 null。
    
    另请参见：
    
    PageFormat， Printable
  - printDialog
```
public abstract boolean printDialog()
                             throws HeadlessException
```
    向用户提供一个对话框，用于更改打印作业的属性。此方法将显示一个本地对话框，如果选择本地打印服务，和打印机的用户选择将被限制在这些本地打印服务。为所有服务提供跨平台的打印对话框，包括本地用 printDialog(PrintRequestAttributeSet)。
    printerjob实现可以使用打字的会更新此printerjob反映用户选定的新服务的打字。
    
    结果
    
    true如果用户不取消对话框； false否则。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - printDialog
```
public boolean printDialog(PrintRequestAttributeSet attributes)
                    throws HeadlessException
```
    一个方便的方法，显示了一个跨平台的打印对话框的所有服务都能够使用 Pageable印刷二维图形界面。当对话框最初显示时选定的打印机将反映当前连接到该打印作业的打印服务。如果用户更改打印服务的printerjob将反映出这个，除非用户取消对话框。以及允许用户选择目标打印机，用户也可以选择不同的打印请求属性的值。
    输入的属性参数将反映在用户对话框中所需的初始选择的应用程序。属性未指定使用服务的默认值。在返回时，它会反映用户的选择。可以通过实施更新选择以与当前选定的打印服务的支持的值一致。
    
    当用户滚动到一个新的打印服务选择时，复制的值基于前一个服务的设置，以及任何用户的更改。值不是基于客户端提供的原始设置。
    
    与选定的打印机外，printerjob状态不更新以反映用户的变化。对影响打印机工作的选择，属性必须指定在调用方法的print(PrintRequestAttributeSet)。如果使用分页界面，它打算使用用户选定的媒体客户必须创造来自用户的选择pageformat。如果用户取消对话框，属性将不会反映用户所做的任何更改。
    
    参数
    
    attributes -输入应用程序提供的属性，对输出的内容被更新以反映用户的选择。此参数不能为空。
    
    结果
    
    true如果用户不取消对话框； false否则。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    NullPointerException -如果 attributes参数为空。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - pageDialog
```
public abstract PageFormat pageDialog(PageFormat page)
                               throws HeadlessException
```
    显示一个对话框，允许一个 PageFormat实例修改。的 page参数用来初始化页面设置对话框控件。如果用户取消对话框，那么这个方法返回原 page对象未修改。如果用户确认对话框然后该方法返回一个新的变化 PageFormat对象。在任何情况下，原 page对象没有被修改。
    
    参数
    
    page -默认 PageFormat提出修改用户
    
    结果
    
    原 page对象如果对话框取消；新的含有格式 PageFormat对象由用户表示如果对话框是公认的。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - pageDialog
```
public PageFormat pageDialog(PrintRequestAttributeSet attributes)
                      throws HeadlessException
```
    一种方便的方法，它显示一个跨平台的页面设置对话框。可供选择的选项将反映打印服务目前在这个printerjob。
    输入的属性参数将反映客户端在用户对话框中所需的初始选择。未使用服务的默认显示的属性。在返回时，它会反映用户的选择。可以通过实施更新选择以与当前选定的打印服务的支持的值一致。
    
    返回值将在PrintRequestAttributeSet的选择pageformat等效。如果用户取消对话框，属性将不会反映用户所做的任何更改，并且返回值将为空。
    
    参数
    
    attributes -输入应用程序提供的属性，对输出的内容被更新以反映用户的选择。此参数不能为空。
    
    结果
    
    一个网页格式，如果用户不取消对话框； null否则。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    NullPointerException -如果 attributes参数为空。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - defaultPage
```
public abstract PageFormat defaultPage(PageFormat page)
```
    克隆 PageFormat争论和改变克隆来描述一个默认的页面大小和方向。
    
    参数
    
    page - PageFormat被克隆和改变
    
    结果
    
    克隆 page，改变默认 PageFormat描述。
  - defaultPage
```
public PageFormat defaultPage()
```
    创建一个新的 PageFormat实例并将其设置为默认的大小和方向。
    
    结果
    
    一个 PageFormat设置一个默认的大小和方向。
  - getPageFormat
```
public PageFormat getPageFormat(PrintRequestAttributeSet attributes)
```
    计算值一致的电流 PrintService支持这项工作 PageFormat（即返回的值 getPrintService()）和媒体，在 attributes包含可打印区域和方向。
    调用此方法不更新作业。那有一套从printDialog(PrintRequestAttributeSet attributes)属性和需要pageformat打印分页对象客户是有用的。
    
    参数
    
    attributes -设置打印属性，例如从调用对话框。如果 attributes为空，默认PageFormat返回。
    
    结果
    
    一个 PageFormat的设置符合当前服务和指定的属性。
    
    从以下版本开始：
    
    一点六
  - validatePage
```
public abstract PageFormat validatePage(PageFormat page)
```
    返回它的设置调整为与本 PrinterJob当前打印机兼容 page克隆。例如，返回的 PageFormat可能有其成像面积调整至适合的纸是由当前的打印机使用的物理区域内。
    
    参数
    
    page - PageFormat是克隆的设置改为与当前打印机兼容
    
    结果
    
    这是一 PageFormat克隆 page和设置的变化符合这 PrinterJob。
  - print
```
public abstract void print()
                    throws PrinterException
```
    打印一组页。
    
    异常
    
    PrinterException在打印系统中的一个错误造成的工作被中止。
    
    另请参见：
    
    Book， Pageable， Printable
  - print
```
public void print(PrintRequestAttributeSet attributes)
           throws PrinterException
```
    在属性集的设置中打印一组页。默认实现忽略属性集。
    请注意，某些属性可以直接通过等效方法的printerjob电话，（例如），副本：setcopies(int)，岗位名称：setJobName(String)和指定媒体的大小和方向虽然PageFormat对象。
    
    如果支持的属性值是该属性指定，它将优先于API设置这个print()操作只。以下行为被指定为pageformat：如果客户端使用打印接口，那么这个方法的参数是attributes检查属性指定媒体（大小）、定位、成像区域，这些都是用来建造一个新的pageformat被传递到打印对象的print()方法。看到所需打印的行为，以确保最佳的印刷经printerjob解释Printable。对客户的pageformat分页界面，总是会通过接口提供，按页。
    
    这些特性允许应用程序直接通过用户设置返回printDialog(PrintRequestAttributeSet attributes这print()方法。
    
    参数
    
    attributes -一套的工作属性
    
    异常
    
    PrinterException在打印系统中的一个错误造成的工作被中止。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Book， Pageable， Printable
  - setCopies
```
public abstract void setCopies(int copies)
```
    设置要打印的副本的数量。
    
    参数
    
    copies -份数要打印
    
    另请参见：
    
    getCopies()
  - getCopies
```
public abstract int getCopies()
```
    获取要打印的副本的数量。
    
    结果
    
    打印的副本的数量。
    
    另请参见：
    
    setCopies(int)
  - getUserName
```
public abstract String getUserName()
```
    获取打印用户的名称。
    
    结果
    
    打印用户的名称
  - setJobName
```
public abstract void setJobName(String jobName)
```
    设置要打印的文档的名称。文件名不能 null。
    
    参数
    
    jobName -文档的名字要打印
    
    另请参见：
    
    getJobName()
  - getJobName
```
public abstract String getJobName()
```
    获取要打印的文档的名称。
    
    结果
    
    要打印的文档的名称。
    
    另请参见：
    
    setJobName(java.lang.String)
  - cancel
```
public abstract void cancel()
```
    取消正在进行的打印作业。如果 print一直叫但没有返回此方法的信号，这项工作应该在下一个机会取消。如果没有打印的工作进度，那么这个调用什么都没有。
  - isCancelled
```
public abstract boolean isCancelled()
```
    返回 true如果打印作业正在进行中，但会在下次有机会取消；否则返回 false。
    
    结果
    
    true如果进展中的工作将被取消； false否则。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class PrinterJob

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

PrinterJob

方法详细信息

getPrinterJob

lookupPrintServices

lookupStreamPrintServices

getPrintService

setPrintService

setPrintable

setPrintable

setPageable

printDialog

printDialog

pageDialog

pageDialog

defaultPage

defaultPage

getPageFormat

validatePage

print

print

setCopies

getCopies

getUserName

setJobName

getJobName

cancel

isCancelled