语言

PrinterDiscoverySession 类

定义

此类封装在打印机发现期间打印服务和系统之间的交互。

[Android.Runtime.Register("android/printservice/PrinterDiscoverySession", DoNotGenerateAcw=true)]
public abstract class PrinterDiscoverySession : Java.Lang.Object
[<Android.Runtime.Register("android/printservice/PrinterDiscoverySession", DoNotGenerateAcw=true)>]
type PrinterDiscoverySession = class
    inherit Object
继承
PrinterDiscoverySession
特性

注解

此类封装在打印机发现期间打印服务和系统之间的交互。 在打印机发现期间,你负责添加已发现的打印机、删除以前添加的打印机以及更新已添加的打印机。

在此会话的生存期内,可能会要求你多次启动和停止执行打印机发现。 将收到启动 PrinterDiscoverySession#onStartPrinterDiscovery(List) 打印机发现呼叫,并收到停止 PrinterDiscoverySession#onStopPrinterDiscovery() 打印机发现的调用。 当系统不再对此会话发现的打印机感兴趣时,你将收到一个调用 #onDestroy() ,此时系统将不再调用会话,并且所有会话方法都不会执行任何操作。

通过调用 PrinterDiscoverySession#addPrinters(List)添加发现的打印机。 添加了通过调用 PrinterDiscoverySession#removePrinters(List)删除消失的打印机。 添加了通过调用 PrinterDiscoverySession#addPrinters(List)更新其属性或功能已更改的打印机。 可以通过返回的打印机是会话期间报告的打印机的 up-to日期快照来获取 #getPrinters() 此会话中添加的打印机。 打印机 不会 跨会话持久保存。

如果需要更新某些打印机,系统将发出调用 #onValidatePrinters(List) 。 无需指定打印机功能即可添加打印机。 这使你能够避免查询所有发现的打印机的功能,而仅在必要时才查询打印机的功能。 例如,如果系统被用户选中,系统将请求更新打印机。 验证打印机时,无需提供打印机的功能,但可能这样做。

如果系统对不断更新打印机状态感兴趣,你将收到一个呼叫 #onStartPrinterStateTracking(PrinterId) ,之后你必须尽最大努力使系统保持更新,以更改打印机状态和功能。 如果在添加打印机时未提供打印机功能,或者打印机将被忽略,则 还必须 更新打印机功能。 当系统不再有兴趣获取打印机的更新时,你将收到一个呼叫 #onStopPrinterStateTracking( PrinterId)。

注意: 此类中的所有回调都在主应用程序线程上执行。 还必须在主应用程序线程上调用此类的任何方法。

Java文档android.printservice.PrinterDiscoverySession。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
PrinterDiscoverySession()

构造 函数。

PrinterDiscoverySession(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
IsDestroyed

获取会话是否已销毁。

IsPrinterDiscoveryStarted

获取是否启动打印机发现。

JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
Printers

获取此会话中报告的打印机。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

TrackedPrinters

获取应跟踪的打印机。

方法

名称 说明
AddPrinters(IList<PrinterInfo>)

添加发现的打印机。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
OnDestroy()

通知你会话已销毁。

OnRequestCustomPrinterIcon(PrinterId, CancellationSignal, CustomPrinterIconCallback)

系统调用以请求打印机的自定义图标。

OnStartPrinterDiscovery(IList<PrinterId>)

回调,要求你启动打印机发现。

OnStartPrinterStateTracking(PrinterId)

回调,要求你开始跟踪打印机的状态。

OnStopPrinterDiscovery()

回调通知你应停止打印机发现。

OnStopPrinterStateTracking(PrinterId)

回调要求你停止跟踪打印机的状态。

OnValidatePrinters(IList<PrinterId>)

要求验证给定打印机是否有效(即存在)的回调。

RemovePrinters(IList<PrinterId>)

删除添加的打印机。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于