The event handler is stored in a HandlerDesc data structure as a PFNHANDLER, along with a pointer to a block of memory allocated and owned by the widget. This pointer will be passed into the widget's event handler with each event to be processed. The HandlerDesc data structure also contains a PFNFREEHANDLER that will be called when the widget is released so that the widget may free the private memory allocated and passed to the event handler.
IForm_SetHandler() associates a given HandlerDesc data structure with a particular form.
- pif:[in] A pointer to an IForm object.
- pd:[in] Pointer to the data structure that contains the event handler, private memory pointer, and the callback used to free the private memory.
void IForm_SetHandler(IForm *pif, HandlerDesc *pd);
The handler installed by a form to process events should itself remember to call HANDLERDESC_Call() so that forms that themselves derive from this form may also hook into the form event handler.