Java javax.print 接口 PrintService（JDK5）

所有类

javax.print
接口 PrintService

所有已知子接口：

MultiDocPrintService

所有已知实现类：

StreamPrintService

public interface PrintService

接口 PrintService 是 DocPrintJob 的工厂。PrintService 描述了打印机的功能，并可查询它来了解打印机支持的属性。

示例：

   DocFlavor flavor = DocFlavor.INPUT_STREAM.POSTSCRIPT;
   PrintRequestAttributeSet aset = new HashPrintRequestHashAttributeSet();
   aset.add(MediaSizeName.ISO_A4);
   PrintService[] pservices =
                 PrintServiceLookup.lookupPrintServices(flavor, aset);
   if (pservices.length > 0) {
       DocPrintJob pj = pservices[0].createPrintJob();
       // InputStreamDoc is an implementation of the Doc interface //
       Doc doc = new InputStreamDoc("test.ps", flavor);
       try {
             pj.print(doc, aset);
        } catch (PrintException e) { 
        }
   }
   

getName

String getName()

返回此 PrintService 的 String 名称，应用程序可以使用该名称来请求特定的 PrintService。在适合的上下文（如名称服务）中，此名称必须是惟一的。在某些环境中，此惟一的名称可能与在 PrinterName 属性中定义的、用户友好的打印机名相同。

返回：

服务名。

createPrintJob

DocPrintJob createPrintJob()

创建并返回一个 PrintJob，它应能够处理取自任意受支持的 docflavor 的数据。

返回：

DocPrintJob 对象

addPrintServiceAttributeListener

void addPrintServiceAttributeListener(PrintServiceAttributeListener listener)

为此 PrintService 上的事件注册一个侦听器。

参数：

listener - PrintServiceAttributeListener，它监视 PrintService 的状态

另请参见：

removePrintServiceAttributeListener(javax.print.event.PrintServiceAttributeListener)

removePrintServiceAttributeListener

void removePrintServiceAttributeListener(PrintServiceAttributeListener listener)

移除此 PrintService 的 PrintService 侦听器。这意味着该侦听器不再侦听 PrintService 事件。

参数：

listener - PrintServiceAttributeListener 对象

另请参见：

addPrintServiceAttributeListener(javax.print.event.PrintServiceAttributeListener)

getAttributes

PrintServiceAttributeSet getAttributes()

获得此 PrintService 的打印机描述属性集，这些属性给出了此 PrintService 的状态。返回的属性集对象是不可修改的。返回的属性集对象是调用 getAttributes() 方法时此 PrintService 的属性集的一个“快照”：也就是说，如果以后此 PrintService 属性集的内容更改了，则不 更新返回的属性集的内容。要检测属性值的更改，可再次调用 getAttributes() 并将新的属性集与以前的属性集进行比较；或者可为 PrintService 事件注册一个侦听器。

返回：

此 PrintService 属性集不可修改的快照。可以为空，但不能为 null。

getAttribute

<T extends PrintServiceAttribute> T getAttribute(Class<T> category)

获得单个指定服务属性的值。这对于只需要一个属性值并且希望最大限度降低开销的客户端而言是很有用的。

参数：

category - 此服务所支持的 PrintServiceAttribute 类别 - 不可以为 null。

返回：

所支持的属性的值，如果此服务不支持该属性，则返回 null。

抛出：

NullPointerException - 如果 category 为 null。

IllegalArgumentException - （未经检查的异常）如果 category 并非实现了接口 PrintServiceAttribute 的 Class。

getSupportedDocFlavors

DocFlavor[] getSupportedDocFlavors()

确定在设置此 PrintService 的作业时，客户端可以指定的打印数据格式。打印数据格式由 "doc flavor"（类 DocFlavor）所指定，该 "doc flavor" 则由 MIME 类型和打印数据表示形式类所组成。

注意，在组合使用所有属性时，可能不支持某些 doc flavor。使用 getUnsupportedAttributes(..) 来验证具体属性组合是否支持 doc flavor。

返回：

受支持的 doc flavor 的数组，至少应该有一个元素。