Most visited

Recently visited

Added in API level 19

PrintJob

public final class PrintJob
extends Object

java.lang.Object
   ↳ android.print.PrintJob


这个类从应用程序的角度来表示一个打印作业。 它包含对其执行操作的行为方法以及查询其状态的方法。 打印作业状态的快照由PrintJobInfo类表示。 打印作业的状态可能随时间而改变。 应用程序在创建打印作业或查询其打印作业时接收此类的实例。

Summary

Public methods

void cancel()

取消此打印作业。

boolean equals(Object obj)

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

PrintJobId getId()

获取唯一的打印作业ID。

PrintJobInfo getInfo()

获取描述此作业的 PrintJobInfo

int hashCode()

返回对象的哈希码值。

boolean isBlocked()

获取此打印作业是否被阻止。

boolean isCancelled()

获取此打印作业是否被取消。

boolean isCompleted()

获取此打印作业是否完成。

boolean isFailed()

获取此打印作业是否失败。

boolean isQueued()

获取此打印作业是否排队。

boolean isStarted()

获取此打印作业是否已启动。

void restart()

重新开始此打印作业。

Inherited methods

From class java.lang.Object

Public methods

cancel

Added in API level 19
void cancel ()

取消此打印作业。 您可以请求取消排队,已启动,已阻止或已失败的打印作业。

也可以看看:

equals

Added in API level 19
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.

Objectequals方法实现了对象上最可能的等价关系; 即对于任何非空参考值xy ,当且仅当xy引用同一对象( 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.

getId

Added in API level 19
PrintJobId getId ()

获取唯一的打印作业ID。

Returns
PrintJobId The id.

getInfo

Added in API level 19
PrintJobInfo getInfo ()

获取描述此作业的 PrintJobInfo

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

Returns
PrintJobInfo The print job info.

hashCode

Added in API level 19
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编程语言不需要此实现技术。)

Returns
int a hash code value for this object.

isBlocked

Added in API level 19
boolean isBlocked ()

获取此打印作业是否被阻止。 这样的打印作业由于异常情况而停止。 您可以通过cancel()申请取消。

Returns
boolean Whether the print job is blocked.

也可以看看:

isCancelled

Added in API level 19
boolean isCancelled ()

获取此打印作业是否被取消。 这样的打印作业由于用户请求而被取消。 这是最后的状态。 您无法重新启动这样的打印作业。

Returns
boolean Whether the print job is cancelled.

isCompleted

Added in API level 19
boolean isCompleted ()

获取此打印作业是否完成。 这样的打印作业已成功打印。 您既不能取消也不能重新启动这样的打印作业。

Returns
boolean Whether the print job is completed.

isFailed

Added in API level 19
boolean isFailed ()

获取此打印作业是否失败。 由于错误,这样的打印作业没有成功打印。 您可以请求通过restart()重新启动或通过cancel()取消。

Returns
boolean Whether the print job is failed.

也可以看看:

isQueued

Added in API level 19
boolean isQueued ()

获取此打印作业是否排队。 这样的打印作业已准备好打印。 您可以通过cancel()申请取消。

Returns
boolean Whether the print job is queued.

也可以看看:

isStarted

Added in API level 19
boolean isStarted ()

获取此打印作业是否已启动。 这样的打印作业正在打印。 您可以通过cancel()申请取消。

Returns
boolean Whether the print job is started.

也可以看看:

restart

Added in API level 19
void restart ()

重新开始此打印作业。 您可以请求重新启动失败的打印作业。

也可以看看:

Hooray!