XtActionHookProc()XtActionHookProc()NameXtActionHookProc - interface definition for 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;
Inputs
w Specifies the widget whose action is about to be dispatched.
client_data
Specifies data that was registered with this procedure in a
call to XtAppAddActionHook().
action_name
Specifies the name of the action to be dispatched.
event Specifies the event argument that will be passed to the
action routine.
params Specifies the action parameters that will be passed to the
action routine.
num_params
Specifies the number of elements in params.
Availability
Release 4 and later.
Description
An XtActionHookProc registered with XtAppAddActionHook() will be called
just before any action procedure is invoked by the Translation Manager.
client_data is whatever data was registered with the action hook proce‐
dure in the call to XtAppAddActionHook(). action_name is the name of
the action procedure that is about to be invoked. It is the name the
action procedure was registered with, and can be used in a call to
XtCallActionProc(). The w, event, params, and num_params arguments are
the arguments that will be passed directly to the action procedure.
Action hooks should not modify any of the data pointed to by the argu‐
ments other than the client_data argument.
Usage
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 AlsoXtAppAddActionHook(1), XtCallActionProc(1), XtRemoveActionHook(1),
XtActionProc(2).
Xt - Translations and Actions XtActionHookProc()