Name

XtActionHookProc — prototype action hook procedure. 

Synopsis

typedef void (∗XtActionHookProc)(Widget, XtPointer, String, XEvent∗, String∗, Cardinal∗)

    Widget w;
    XtPointer client_data;
    String action_name;
    XEvent ∗event;
    String ∗params;
    Cardinal ∗num_params;

Arguments

wSpecifies the widget whose action is about to be dispatched. 

client_data
Specifies the application-specific closure that was passed to XtAppAddActionHook. 

action_name
Specifies the name of the action to be dispatched.

eventSpecifies the event argument that will be passed to the action routine. 

paramsSpecifies the action parameters that will be passed to the action routine. 

num_params
Specifies the count of entries in params.

Description

An application can specify a procedure that will be called just before every action routine is dispatched by the translation manager.  To do so, the application supplies a procedure pointer of type XtActionHookProc.  Action hooks should not modify any of the data pointed to by the arguments other than the client_data argument. 

One use of an XtActionHookProc is to record the arguments passed to each action so that user actions are recorded for later playback using XtCallActionProc.  This is one way to implement keyboard macros. 

See Also

XtAppAddActionHook(1), XtCallActionProc(1), XtRemoveActionHook(1).