XtActionHoo(3x) — HP-UX 9.05

NAME

XtActionHookProc − 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

wSpecifies 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.

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 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 procedure 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 arguments 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.

Museum