PrintJob

block

boolean block (String reason)

阻止打印作业。 如果isStarted()返回true，并且您需要阻止打印作业，则应该调用此方法。 例如，用户必须添加一些纸张才能继续打印。 要恢复打印作业，请致电start() 。 要更改原因，请致电setStatus(CharSequence) 。

cancel

boolean cancel ()

取消打印作业。 如果isQueued()或or #isBlocked()返回true，并且您取消了打印作业作为对onRequestCancelPrintJob(PrintJob)的呼叫的响应，则应该调用此方法。

complete

boolean complete ()

完成打印作业。 如果isStarted()返回true并且您已完成打印，则应该调用此方法。

equals

boolean equals (Object obj)

指示其他某个对象是否“等于”这一个。

equals方法在非空对象引用上实现等价关系：

• It is reflexive: for any non-null reference value x, x.equals(x) should return true.
• It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
• It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
• It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
• For any non-null reference value x, x.equals(null) should return false.

类Object的equals方法实现了对象上最可能的等价关系; 也就是说，对于任何非空参考值x和y ，当且仅当x和y引用同一对象（ x == y的值为true ）时，此方法返回true 。

请注意，无论何时覆盖此方法，通常都必须覆盖 hashCode方法，以便维护 hashCode方法的一般合约，该方法声明相等对象必须具有相同的散列代码。

fail

boolean fail (String error)

打印作业失败。 如果在打印时isQueued()或isStarted()或isBlocked()返回true，则应该调用此方法。

getAdvancedIntOption

int getAdvancedIntOption (String key)

获取高级（打印机特定）打印选项的值。

getAdvancedStringOption

String getAdvancedStringOption (String key)

获取高级（打印机特定）打印选项的值。

getDocument

PrintDocument getDocument ()

获取打印文档。

getId

PrintJobId getId ()

获取唯一的打印作业ID。

getInfo

PrintJobInfo getInfo ()

获取描述此作业的 PrintJobInfo 。

节点：返回的信息对象是当前打印作业状态的快照。 每次调用此方法都会返回一个反映当前打印作业状态的新信息对象。

getTag

String getTag ()

获取打印作业标记。

hasAdvancedOption

boolean hasAdvancedOption (String key)

获取此作业是否具有给定的高级（打印机特定）打印选项。

hashCode

int hashCode ()

返回对象的哈希码值。 为了散列表的好处而支持此方法，例如HashMap提供的HashMap 。

hashCode的总合同是：

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

尽可能合理实用，类Object定义的hashCode方法确实为不同的对象返回不同的整数。 （这通常通过将对象的内部地址转换为整数来实现，但Java ^TM编程语言不需要此实现技术。）

isBlocked

boolean isBlocked ()

获取此打印作业是否被阻止。 这样的打印作业因异常情况而停止，可以启动，取消或失败。

isCancelled

boolean isCancelled ()

获取此打印作业是否被取消。 这样的打印作业由于用户请求而被取消。 这是最后的状态。

isCompleted

boolean isCompleted ()

获取此打印作业是否完成。 这样的打印作业已成功打印。 这是最后的状态。

isFailed

boolean isFailed ()

获取此打印作业是否失败。 由于错误，这样的打印作业没有成功打印。 这是最后的状态。

isQueued

boolean isQueued ()

获取此打印作业是否排队。 这样的打印作业已准备好打印并可以启动或取消。

isStarted

boolean isStarted ()

获取此打印作业是否已启动。 这样的打印作业正在打印并且可以完成，取消或失败。

setProgress

void setProgress (float progress)

将此打印作业的进度设置为1的一部分。

setStatus

void setStatus (CharSequence status)

设置此打印作业的状态。 这应该是对打印作业当前状态的可读，简短和翻译的描述。

setStatus

void setStatus (int statusResId)

将此打印作业的状态设置为字符串资源。

setTag

boolean setTag (String tag)

设置在PrintService的上下文中有效且不被系统解释的标签。 例如，打印服务可以将远程打印服务器返回的打印作业的关键字设置为标签，如果打印不在基于云的服务中的话。

start

boolean start ()

开始打印作业。 如果isQueued()或isBlocked()返回true，并且您开始恢复打印，则应该调用此方法。

这会将打印状态重置为空。 使用setStatus(int)设置新状态。