The IWindowHandle class is a wrapper for handles of presentation system windows.
Use IWindowHandle in system calls where the X Toolkit type Widget is required.
Use IWindowHandle in system calls where the OS/2 Programmer's Toolkit type HWND is required.
Use IWindowHandle in system calls where the Win32 SDK type HWND is required.
Constructors & DestructorYou can construct objects of this class.
![]() |
public:
IWindowHandle(Value value = 0)
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
DiagnosticsUse these members to obtain diagnostic information.
![]() |
public:
IString asDebugInfo() const
Returns the handle as a string containing diagnostic information.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
IString asString() const
Returns the handle as a string of form nnnn.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
unsigned long asUnsigned() const
Returns the handle value as an unsigned long value.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
Sending and Posting EventsUse these members to send or post an event to a window handle or handles.
![]() |
public:
void postEvent( unsigned long eventId, const IEventParameter1& parm1 = 0ul, const IEventParameter2& parm2 = 0ul ) const
Posts an event constructed from the parameters to the window identified by this handle.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
void postEvents( unsigned long eventId, const IEventParameter1& parm1 = 0ul, const IEventParameter2& parm2 = 0ul, BroadcastTo value = descendants ) const
Posts one event to multiple windows.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
IEventResult sendEvent( unsigned long eventId, const IEventParameter1& parm1 = 0ul, const IEventParameter2& parm2 = 0ul ) const
Sends an event constructed from the parameters to the window identified by this handle.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
void sendEvents( unsigned long eventId, const IEventParameter1& parm1 = 0ul, const IEventParameter2& parm2 = 0ul, BroadcastTo value = descendants ) const
Broadcasts one event to multiple windows.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
TestingUse these members to test a window handle.
![]() |
public:
bool isValid() const
If the window handle is valid, true is returned.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
Type ConversionsType conversion operators convert objects of this class to a different type.
![]() |
public:
operator Value() const
Returns the handle as its operating system dependent type. Use this operator when you use the handle object as an argument to an operating system function.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
enum BroadcastTo { descendants,
frames,
frameDescendants }Use these enumerators to specify post and send event-broadcasting attributes:
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
typedef INativeWindowHandle Value
This type definition is a synonym for the type used by the operating system for a window handle object. Use objects of this type for operating system function calls which require a window handle.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |