PrinterDiscoverySession 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
此类封装在打印机发现期间打印服务和系统之间的交互。
[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#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 |
返回此 |
| 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 |
获取应跟踪的打印机。 |
方法
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |