public final class PrintJob
extends Object
java.lang.Object | |
↳ | android.print.PrintJob |
这个类从应用程序的角度来表示一个打印作业。 它包含对其执行操作的行为方法以及查询其状态的方法。 打印作业状态的快照由PrintJobInfo
类表示。 打印作业的状态可能随时间而改变。 应用程序在创建打印作业或查询其打印作业时接收此类的实例。
Public methods |
|
---|---|
void |
cancel() 取消此打印作业。 |
boolean |
equals(Object obj) 指示其他某个对象是否“等于”这一个。 |
PrintJobId |
getId() 获取唯一的打印作业ID。 |
PrintJobInfo |
getInfo() 获取描述此作业的 |
int |
hashCode() 返回对象的哈希码值。 |
boolean |
isBlocked() 获取此打印作业是否被阻止。 |
boolean |
isCancelled() 获取此打印作业是否被取消。 |
boolean |
isCompleted() 获取此打印作业是否完成。 |
boolean |
isFailed() 获取此打印作业是否失败。 |
boolean |
isQueued() 获取此打印作业是否排队。 |
boolean |
isStarted() 获取此打印作业是否已启动。 |
void |
restart() 重新开始此打印作业。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
boolean equals (Object obj)
指示其他某个对象是否“等于”这一个。
equals
方法在非空对象引用上实现等价关系:
x
, x.equals(x)
should return true
. x
and y
, x.equals(y)
should return true
if and only if y.equals(x)
returns true
. x
, y
, and z
, if x.equals(y)
returns true
and y.equals(z)
returns true
, then x.equals(z)
should return true
. 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. x
, x.equals(null)
should return false
. 类Object
的equals
方法实现了对象上最可能的等价关系; 即对于任何非空参考值x
和y
,当且仅当x
和y
引用同一对象( x == y
具有值true
)时,此方法返回true
。
请注意,无论何时覆盖此方法,通常都必须覆盖 hashCode
方法,以便维护 hashCode
方法的常规协定,该方法声明相等对象必须具有相同的哈希代码。
Parameters | |
---|---|
obj |
Object : the reference object with which to compare. |
Returns | |
---|---|
boolean |
true if this object is the same as the obj argument; false otherwise. |
PrintJobInfo getInfo ()
获取描述此作业的 PrintJobInfo
。
节点:返回的信息对象是当前打印作业状态的快照。 每次调用此方法都会返回一个反映当前打印作业状态的新信息对象。
Returns | |
---|---|
PrintJobInfo |
The print job info. |
int hashCode ()
返回对象的哈希码值。 此方法受益于散列表(如HashMap
提供的HashMap
。
hashCode
的总合同是:
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. equals(Object)
method, then calling the hashCode
method on each of the two objects must produce the same integer result. 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编程语言不需要此实现技术。)
Returns | |
---|---|
int |
a hash code value for this object. |
boolean isBlocked ()
获取此打印作业是否被阻止。 这样的打印作业由于异常情况而停止。 您可以通过cancel()
申请取消。
Returns | |
---|---|
boolean |
Whether the print job is blocked. |
也可以看看:
boolean isCancelled ()
获取此打印作业是否被取消。 这样的打印作业由于用户请求而被取消。 这是最后的状态。 您无法重新启动这样的打印作业。
Returns | |
---|---|
boolean |
Whether the print job is cancelled. |
boolean isCompleted ()
获取此打印作业是否完成。 这样的打印作业已成功打印。 您既不能取消也不能重新启动这样的打印作业。
Returns | |
---|---|
boolean |
Whether the print job is completed. |
boolean isFailed ()
获取此打印作业是否失败。 由于错误,这样的打印作业没有成功打印。 您可以请求通过restart()
重新启动或通过cancel()
取消。
Returns | |
---|---|
boolean |
Whether the print job is failed. |
boolean isQueued ()
获取此打印作业是否排队。 这样的打印作业已准备好打印。 您可以通过cancel()
申请取消。
Returns | |
---|---|
boolean |
Whether the print job is queued. |
也可以看看:
boolean isStarted ()
获取此打印作业是否已启动。 这样的打印作业正在打印。 您可以通过cancel()
申请取消。
Returns | |
---|---|
boolean |
Whether the print job is started. |
也可以看看: