所有类

概述 软件包  类 使用 树 已过时 索引 帮助 
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

java.awt.print
类 PrinterJob

java.lang.Object
  继承者 java.awt.print.PrinterJob

public abstract class PrinterJob
   
   
   
   
   
extends Object

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

构造方法摘要
PrinterJob()
          应使用静态 getPrinterJob 方法创建 PrinterJob 对象。
 
方法摘要
abstract  voidcancel()
          取消正在进行的打印作业。
 PageFormatdefaultPage()
          创建新的 PageFormat 实例，并将它设置为默认大小和方向。
abstract  PageFormatdefaultPage(PageFormat page)
          克隆 PageFormat 参数，并更改该克隆，以描述默认页面的大小和方向。
abstract  intgetCopies()
          获取要打印的副本数。
abstract  StringgetJobName()
          获取要打印的文档名称。
static PrinterJobgetPrinterJob()
          创建并返回最初与默认打印机关联的 PrinterJob。
 PrintServicegetPrintService()
          返回此打印机作业的服务（打印机）。
abstract  StringgetUserName()
          获取打印用户的名称。
abstract  booleanisCancelled()
          如果打印作业正在进行中，而下一次将被取消，则返回 true；否则返回 false。
static PrintService[]lookupPrintServices()
          查找 2D 打印服务的便捷方法。
static StreamPrintServiceFactory[]lookupStreamPrintServices(String mimeType)
          定位可以成像 2D 图形的流打印服务工厂的便捷方法。
abstract  PageFormatpageDialog(PageFormat page)
          显示允许修改 PageFormat 实例的对话框。
 PageFormatpageDialog(PrintRequestAttributeSet attributes)
          显示跨平台页面设置对话框的便捷方法。
abstract  voidprint()
          打印一组页面。
 voidprint(PrintRequestAttributeSet attributes)
          使用属性集中的设置打印一组页面。
abstract  booleanprintDialog()
          向用户呈现一个对话框，用来更改打印作业的属性。
 booleanprintDialog(PrintRequestAttributeSet attributes)
          为所有服务显示跨平台打印对话框的便捷方法，这些服务能够使用 Pageable 接口打印 2D 图形。
abstract  voidsetCopies(int copies)
          设置要打印的副本数。
abstract  voidsetJobName(String jobName)
          设置要打印的文档名称。
abstract  voidsetPageable(Pageable document)
          查询 document，以获得页数以及 Pageable 实例 document 中保存的每个页面的 PageFormat 和 Printable。
abstract  voidsetPrintable(Printable painter)
          调用 painter 以呈现该页面。
abstract  voidsetPrintable(Printable painter, PageFormat format)
          调用 painter，以用指定的 format 呈现该页面。
 voidsetPrintService(PrintService service)
          将此 PrinterJob 与新的 PrintService 关联。
abstract  PageFormatvalidatePage(PageFormat page)
          返回 page 的克隆，调整其设置，以与此 PrinterJob 的当前打印机兼容。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

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 - 要打印的每个页面的大小和方向