Java java.awt.print 类 PrinterJob（JDK5）

所有类

java.awt.print
类 PrinterJob

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

public abstract class PrinterJob
   
   
   
   
   
extends Object
   
   
   
   
   

PrinterJob 类是控制打印的主要类。应用程序调用此类中的方法以设置作业、以可选方式调用与用户的打印对话框，然后打印作业的页面。

PrinterJob

public PrinterJob()

应使用静态 getPrinterJob 方法创建 PrinterJob 对象。

getPrinterJob

public static PrinterJob getPrinterJob()

创建并返回最初与默认打印机关联的 PrinterJob。如果系统上没有可用的打印机，则仍从此方法返回 PrinterJob，但是，getPrintService() 将返回 null，并且使用此 PrinterJob 调用 print 可能产生异常。需要在创建 PrinterJob 之前确定是否有合适打印机的应用程序应确保从 lookupPrintServices 返回的数组不为空。

返回：

新的 PrinterJob。

lookupPrintServices

public static PrintService[] lookupPrintServices()

查找 2D 打印服务的便捷方法。在支持打印服务的 PrinterJob 上可以安装从此方法返回的服务。调用此方法等效于调用 PrintServiceLookup.lookupPrintServices() 并指定一个 Pageable DocFlavor。

返回：

2D 打印服务的可能为空的数组。

从以下版本开始：

1.4

lookupStreamPrintServices

public static StreamPrintServiceFactory[] lookupStreamPrintServices(String mimeType)

定位可以成像 2D 图形的流打印服务工厂的便捷方法。示例用法：

 FileOutputStream outstream;
 StreamPrintService psPrinter;
 String psMimeType = "application/postscript";

 StreamPrintServiceFactory[] factories =
     PrinterJob.lookupStreamPrintServices(psMimeType);
 if (factories.length > 0) {
     try {
         outstream = new File("out.ps");
         psPrinter =  factories[0].getPrintService(fos);
         // psPrinter can now be set as the service on a PrinterJob 
     } catch (FileNotFoundException e) {
     }
 }            
 

在支持打印服务的 PrinterJob 实例上可以安装从此方法返回的服务。调用此方法等效于调用 StreamPrintServiceFactory.lookupStreamPrintServiceFactories() 并指定一个 Pageable DocFlavor。

参数：

mimeType - 需要的输出格式，或 null（指任何格式）。

返回：

2D 流打印服务工厂的可能为空的数组。

从以下版本开始：

1.4

getPrintService

public PrintService getPrintService()

返回此打印机作业的服务（打印机）。不支持打印服务的此类的实现可能返回 null；

返回：

此打印机作业的服务。

从以下版本开始：

1.4

另请参见：

setPrintService(PrintService)

setPrintService

public void setPrintService(PrintService service)
                     throws PrinterException

将此 PrinterJob 与新的 PrintService 关联。支持指定 Print Service 的子类重写此方法。 如果指定的服务不能支持执行 2D 打印所需的 Pageable 和 Printable 接口，则抛出 PrinterException。

参数：

service - 支持 2D 打印的打印服务

抛出：

PrinterException - 如果指定的服务不支持 2D 打印，或此 PrinterJob 类不支持设置 2D 打印服务，或指定的服务不是有效的打印服务。

从以下版本开始：

1.4

另请参见：

getPrintService()

setPrintable

public abstract void setPrintable(Printable painter)

调用 painter 以呈现该页面。Printable 对象 painter 可以呈现由此 PrinterJob 打印的文档中的页面。每页的 PageFormat 是默认的页面格式。

参数：

painter - 呈现该文档每个页面的 Printable。

setPrintable

public abstract void setPrintable(Printable painter,
                                  PageFormat format)

调用 painter，以用指定的 format 呈现该页面。Printable 对象 painter 可以呈现由此 PrinterJob 打印的文档中的页面。每个页面的 PageFormat 为 format。

参数：

painter - 呈现该文档的每个页面所调用的 Printable

format - 要打印的每个页面的大小和方向