Name

XtInsertEventHandler — register an event handler procedure that receives events before or after all previously registered event handlers. 

Synopsis

void XtInsertEventHandler(w, event_mask, nonmaskable, proc, client_data, position)

    Widget w;
    EventMask event_mask;
    Boolean nonmaskable;
    XtEventHandler proc;
    XtPointer client_data;
    XtListPosition position;

Arguments

wSpecifies the widget for which this event handler is being registered. 

event_mask
Specifies the event mask for which to call this procedure.

nonmaskable
Specifies whether this procedure should be called on the nonmaskable events (GraphicsExpose, NoExpose, SelectionClear, SelectionRequest, SelectionNotify, ClientMessage, and MappingNotify). 

procSpecifies the procedure that is to be called. 

client_data
Specifies additional data to be passed to the client’s event handler.

positionSpecifies when the event handler is to be called relative to other previously registered handlers. 

Description

XtInsertEventHandler is identical to XtAddEventHandler with the additional position argument.  The two values for position are described as follows:

XtListHead
The event handler is registered so that it will be called before any event handlers that were previously registered for the same widget. 

XtListEndThe event handler is registered to be called after any event handlers previously registered. 

If the procedure is already registered with the same client_data, the specified mask augments the existing mask, and the procedure is repositioned in the list. 

Structures

typedef enum {XtListHead, XtListTail} XtListPosition;

See Also

XtAddEventHandler(1), XtAddRawEventHandler(1), XtBuildEventMask(1), XtInsertRawEventHandler(1), XtRemoveEventHandler(1), XtRemoveRawEventHandler(1).