javax.print

Interface DocPrintJob

All Known Subinterfaces:

CancelablePrintJob， MultiDocPrintJob

public interface DocPrintJob

此接口表示一个打印作业，可以打印一个指定的文档，具有一组工作属性。实现此接口的对象从打印服务获得。

方法摘要

Modifier and Type	Method and Description
void	addPrintJobAttributeListener(PrintJobAttributeListener listener, PrintJobAttributeSet attributes) 为指定的属性更改的侦听器注册侦听器。
void	addPrintJobListener(PrintJobListener listener) 在一个打印作业期间注册一个事件的侦听器。
PrintJobAttributeSet	getAttributes() 获取此打印作业的打印属性集。
PrintService	getPrintService() 决定 PrintService对象的打印作业对象绑定。
void	print(Doc doc, PrintRequestAttributeSet attributes) 用指定的作业属性打印文档。
void	removePrintJobAttributeListener(PrintJobAttributeListener listener) 从这个打印作业中移除一个属性侦听器。
void	removePrintJobListener(PrintJobListener listener) 从这个打印作业中移除一个侦听器。

方法详细信息

getPrintService

PrintService getPrintService()

决定 PrintService对象的打印作业对象绑定。

结果

PrintService对象。

getAttributes

PrintJobAttributeSet getAttributes()

获取此打印作业的打印属性集。返回的对象是不可修改的属性集。返回的属性设置的对象是一个“快照”这个打印作业的属性设置在 getAttributes()方法调用的时间；即，返回的属性的对象的内容将不会被更新，如果将来改变打印作业的属性集的内容。检测属性值的变化，又称 getAttributes()比较集前面的属性设置新的属性；另外，登记一个打印作业的事件监听器。返回的值可能是一个空集，但不应该是空的。

结果

打印作业属性

addPrintJobListener

void addPrintJobListener(PrintJobListener listener)

在一个打印作业期间注册一个事件的侦听器。如果侦听器为空，则不会引发异常，并没有执行任何动作。如果侦听器已经注册，它将再次注册。

参数

listener -实现监听器接口

另请参见：

removePrintJobListener(javax.print.event.PrintJobListener)

removePrintJobListener

void removePrintJobListener(PrintJobListener listener)

从这个打印作业中移除一个侦听器。此方法不执行任何功能，也不抛出一个异常，如果参数中指定的侦听器没有在此组件中添加到该组件中。如果侦听器为空，则不会引发异常，并没有执行任何动作。如果一个侦听器被注册不止一次，只有一个注册将被删除。

参数

listener -实现监听器接口

另请参见：

addPrintJobListener(javax.print.event.PrintJobListener)

addPrintJobAttributeListener

void addPrintJobAttributeListener(PrintJobAttributeListener listener,
                                  PrintJobAttributeSet attributes)

为指定的属性更改的侦听器注册侦听器。如果侦听器为空，则不会引发异常，并没有执行任何动作。确定可报告的工作属性的更新，客户端可以调用 getAttributes()和发现有趣和容易被报告给听众的子集。客户期望在一个特定的工作属性的变化进行更新，应验证它是在该集，但只有当它发生变化，这是由工作检测到的属性的更新。也可能会受到作业批量的更新。为了尽量减少在打印作业处理的开销，建议只听的属性的子集，这是可能改变。如果指定的设置为空，则将向侦听器报告任何属性更新。如果属性集是无效的，那么这就意味着要侦听作业支持的所有动态属性。如果一个作业不能报告任何属性更新，这可能会导致没有更新通知。如果侦听器已经注册，它将再次注册。

参数

listener -实现监听器接口

attributes -听的属性，或零意味着所有的属性可以改变，由工作决定。

另请参见：

removePrintJobAttributeListener(javax.print.event.PrintJobAttributeListener)

removePrintJobAttributeListener

void removePrintJobAttributeListener(PrintJobAttributeListener listener)

从这个打印作业中移除一个属性侦听器。此方法不执行任何功能，也不抛出一个异常，如果参数中指定的侦听器没有在此组件中添加到该组件中。如果侦听器是空的，则不会引发异常，并没有执行任何动作。如果一个侦听器被注册超过一次，即使对于一个不同的属性集，也不能保证侦听器被删除。

参数

listener -实现监听器接口

另请参见：

addPrintJobAttributeListener(javax.print.event.PrintJobAttributeListener, javax.print.attribute.PrintJobAttributeSet)

print

void print(Doc doc,
           PrintRequestAttributeSet attributes)
    throws PrintException

用指定的作业属性打印文档。此方法只对一个给定的打印作业只进行一次调用。叫它又不会导致被卷绕到打印机的新工作。服务实现将定义服务中断和恢复的策略。当打印方法返回时，打印可能还没有完成，因为打印可能是异步发生的，也许是在一个不同的线程中发生的。应用客户想要监测的成功或失败的一个printjoblistener应登记。

打印服务实现者应该关闭任何打印数据流（即读者或InputStream实现），他们从客户端文件获取。稳健的客户可能仍然希望验证这一。一个例外是如果一个DocFlavor不能印产生。

参数

doc -要打印的文档。如果必须通过这味道PRINTJOB支持。

attributes -工作属性适用于该打印作业。如果此参数为空，则使用默认属性。

异常

PrintException除外--还可以实现一个接口，更准确地描述了异常

• flavorexception。如果文档有一个不支持此打印作业的味道。
• attributeexception。如果一个或多个属性不适用于此打印作业。

原因