Description
Posts an event onto the event queue. The posted event will not be executed until the current event chain is completed. Compare to Send_Event.
Syntax
status = Post_Event (targetctrl, eventname[, arg, ...])
Parameters
The Post_Event function has the following parameters.
| Parameter | Description |
|---|---|
| targetctrl | Specifies the window or control to post the event to. To post an event to a window, pass the window ID; to post to a control, specify the control entity ID (CtrlEntID) as the control name concatenated to the window ID and separated by a period. For a single-instance window, the window ID is always identical to the window name; for multi-instance windows, the window ID, returned from Start_windows or an equivalent function, is not necessarily the window name. |
| eventname | A valid event name, such as CLICK, READ, OMNIEVENT, and CLOSE. |
| arg... | Pass any number of arguments that are needed by the event handler associated with the event specified in eventname, up to 20 are supported. |
Use Post_Event as a mechanism of delaying time consuming processing that does not have to be done immediately.
See also
Get_EventStatus(), Send_Event(), Set_EventStatus(), Chapter 5: Events
