Handler 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
处理程序允许你发送和处理 Message 与线程 MessageQueue关联的可运行对象。
[Android.Runtime.Register("android/os/Handler", DoNotGenerateAcw=true)]
public class Handler : Java.Lang.Object[<Android.Runtime.Register("android/os/Handler", DoNotGenerateAcw=true)>]
type Handler = class
inherit Object- 继承
- 派生
- 属性
注解
处理程序允许你发送和处理 Message 与线程 MessageQueue关联的可运行对象。 每个处理程序实例都与单个线程和该线程的消息队列相关联。 创建新的处理程序时，它绑定到一个 Looper。 它将将消息和可运行对象传递到该 Looper 的消息队列，并在该 Looper 的线程上执行它们。
处理程序有两个主要用途：（1）计划将在将来某个时间点执行的消息和可运行项：和 （2） 将操作排入队列以在与你自己的线程不同的线程上执行。
计划消息是使用 #post、#postAtTime(Runnable, long)、#postDelayed、#sendEmptyMessage#sendMessage、 #sendMessageAtTime和#sendMessageDelayed方法完成的。 em <post</em> 版本允许在收到消息队列时对 Runnable 对象进行排队;<em>sendMessage</em> 版本允许对包含处理程序方法处理的数据捆绑包的对象进行排队Message（需要实现 Handler #handleMessage>的子类）。
在向处理程序发布或发送时，可以允许在消息队列准备就绪后立即处理该项，或者指定处理前的延迟或处理它的绝对时间。 后两个允许实现超时、时钟周期和其他基于计时的行为。
为应用程序创建进程时，其主线程专用于运行消息队列，该队列负责管理顶级应用程序对象（活动、广播接收器等）及其创建的任何窗口。 可以创建自己的线程，并通过处理程序与主应用程序线程通信。 这可以通过像以前一样调用相同的 <em>post</em> 或 <em>sendMessage</em> 方法来完成，但从新线程调用。 然后，将在处理程序的消息队列中计划给定的 Runnable 或 Message，并在适当时进行处理。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| Handler() |
默认构造函数将此处理程序与 |
| Handler(Action<Message>) |
处理程序允许你发送和处理 |
| Handler(Handler+ICallback) |
构造函数将此处理程序与 Looper 当前线程相关联，并获取一个回调接口，可在其中处理消息。 |
| Handler(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
| Handler(Looper, Handler+ICallback) |
使用提供的 Looper 而不是默认接口，并获取用于处理消息的回调接口。 |
| Handler(Looper) |
使用提供的 |
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
处理程序允许你发送和处理 |
| JniPeerMembers |
处理程序允许你发送和处理 |
| Looper | |
| PeerReference |
处理程序允许你发送和处理 |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
方法
| 名称 | 说明 |
|---|---|
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| CreateAsync(Looper, Handler+ICallback) |
创建一个新的处理程序，其发布的消息和可运行对象不受同步屏障（如显示 vsync）的约束。 |
| CreateAsync(Looper) |
创建一个新的处理程序，其发布的消息和可运行对象不受同步屏障（如显示 vsync）的约束。 |
| DispatchMessage(Message) |
在此处处理系统消息。 |
| Dispose() |
处理程序允许你发送和处理 |
| Dispose(Boolean) |
处理程序允许你发送和处理 |
| Dump(IPrinter, String) | |
| DumpAsync(IPrinter, String) |
处理程序允许你发送和处理 |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetMessageName(Message) |
返回一个字符串，表示指定消息的名称。 |
| HandleMessage(Message) |
子类必须实现此操作才能接收消息。 |
| HasCallbacks(IRunnable) |
检查消息队列中是否有任何具有回调 r 的消息挂起的帖子。 |
| HasMessages(Int32, Object) |
检查是否有代码为“what”且其 obj 为消息队列中的“object”的消息挂起的帖子。 |
| HasMessages(Int32) |
检查消息队列中是否有代码为“what”的消息挂起的帖子。 |
| JavaFinalize() |
当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| ObtainMessage() |
从全局消息池返回一个新 |
| ObtainMessage(Int32, Int32, Int32, Object) |
与 |
| ObtainMessage(Int32, Int32, Int32) |
与 |
| ObtainMessage(Int32, Object) |
与 |
| ObtainMessage(Int32) |
同样 |
| Post(Action) |
处理程序允许你发送和处理 |
| Post(IRunnable) |
使 Runnable r 添加到消息队列。 |
| PostAtFrontOfQueue(Action) |
处理程序允许你发送和处理 |
| PostAtFrontOfQueue(IRunnable) |
将消息发布到实现 Runnable 的对象。 |
| PostAtTime(Action, Int64) |
处理程序允许你发送和处理 |
| PostAtTime(Action, Object, Int64) |
处理程序允许你发送和处理 |
| PostAtTime(IRunnable, Int64) |
使 Runnable r 添加到消息队列，在特定时间由 <var>运行时间Millis</var> 提供。 |
| PostAtTime(IRunnable, Object, Int64) |
使 Runnable r 添加到消息队列，在特定时间由 <var>运行时间Millis</var> 提供。 |
| PostDelayed(Action, Int64) |
处理程序允许你发送和处理 |
| PostDelayed(IRunnable, Int64) |
使 Runnable r 添加到消息队列，在指定的时间过后运行。 |
| PostDelayed(IRunnable, Object, Int64) |
使 Runnable r 添加到消息队列，在指定的时间过后运行。 |
| RemoveCallbacks(Action, Object) |
处理程序允许你发送和处理 |
| RemoveCallbacks(Action) |
处理程序允许你发送和处理 |
| RemoveCallbacks(IRunnable, Object) |
使用消息队列中的对象 var token/var 删除 Runnable <>var r</var>< 的任何挂起帖子。><> |
| RemoveCallbacks(IRunnable) |
删除消息队列中 Runnable r 的任何挂起帖子。 |
| RemoveCallbacksAndMessages(Object) |
删除回调的任何挂起帖子，并发送其 <var>obj</var> 为 <var>token</var> 的消息。 |
| RemoveMessages(Int32, Object) |
删除包含代码“what”且其 obj 为消息队列中的“object”的消息的任何挂起帖子。 |
| RemoveMessages(Int32) |
删除消息队列中代码为“what”的消息的任何挂起帖子。 |
| SendEmptyMessage(Int32) |
发送仅包含值的消息。 |
| SendEmptyMessageAtTime(Int32, Int64) |
发送仅包含要在特定时间传递的值的消息。 |
| SendEmptyMessageDelayed(Int32, Int64) |
发送一条消息，其中包含在指定的时间量过后要传递的值。 |
| SendMessage(Message) |
将所有挂起的消息推送到消息队列的末尾，然后再推送到当前时间之前。 |
| SendMessageAtFrontOfQueue(Message) |
将消息排入消息队列的前面，以在消息循环的下一次迭代中进行处理。 |
| SendMessageAtTime(Message, Int64) |
在绝对时间（以毫秒为单位） <var>运行时间Millis</var> 之前将所有挂起的消息排入消息队列。 |
| SendMessageDelayed(Message, Int64) |
将所有挂起的消息排入消息队列之前（当前时间 + delayMillis） 之后。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| ToArray<T>() |
处理程序允许你发送和处理 |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
处理程序允许你发送和处理 |
| Wait() |
使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
处理程序允许你发送和处理 |
| IJavaPeerable.DisposeUnlessReferenced() |
处理程序允许你发送和处理 |
| IJavaPeerable.Finalized() |
处理程序允许你发送和处理 |
| IJavaPeerable.JniManagedPeerState |
处理程序允许你发送和处理 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
处理程序允许你发送和处理 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
处理程序允许你发送和处理 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
处理程序允许你发送和处理 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
处理程序允许你发送和处理 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |