ComponentDispatcher Class
Enables shared control of the message pump between Win32 and WPF in interoperation scenarios.
Assembly: WindowsBase (in WindowsBase.dll)
The ComponentDispatcher type exposes the following members.
| Name | Description | |
|---|---|---|
|
CurrentKeyboardMessage | Gets the last message that was raised. |
|
|
IsThreadModal | Gets a value that indicates whether the thread is modal. |
| Name | Description | |
|---|---|---|
|
PopModal | Called to indicate that a modal thread is no longer modal. |
|
|
PushModal | Called to indicate that the thread is modal. |
|
|
RaiseIdle | Called to indicate that a thread is idle. |
|
|
RaiseThreadMessage | Indicates that a new message is available for possible handling. |
| Name | Description | |
|---|---|---|
|
EnterThreadModal | Occurs when a thread becomes modal. |
|
|
LeaveThreadModal | Occurs when a modal thread becomes nonmodal. |
|
|
ThreadFilterMessage | Occurs when the message pump receives a keyboard message. |
|
|
ThreadIdle | Occurs when the thread is idle. |
|
|
ThreadPreprocessMessage | Occurs when the message pump receives a keyboard message. |
Although the class itself is static, all members of ComponentDispatcher are specific to a particular thread. For example, if you examine the value of IsThreadModal on two different threads, you might get different values.
The methods are static but they are backed by per-thread data structures. The static methods allow singleton access but the ComponentDispatcher is sorting out the appropriate per-thread operations.
The owner of the message pump is defined by the code that calls the Win32 function GetMessage. The owner calls RaiseThreadMessage for every keyboard message. This method raises the ThreadFilterMessage event with the messages contained in the event data. If that event is not handled, the owner raises the ThreadPreprocessMessage event with the messages contained in the event argument.
Note
|
|---|
|
Only keyboard messages are supported. |
-
UIPermission
to access any member of this class. Associated enumeration: Unrestricted
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
