NAME

XtAppAddActionHook − register a procedure to be called before any action is invoked. 

Synopsis

XtActionHookId XtAppAddActionHook(app, proc, client_data)

      XtAppContext app;
      XtActionHookProc proc;
      XtPointer client_data;

Inputs

appSpecifies the application context. 

procSpecifies the action hook procedure. 

client_data
Specifies data to be passed to the procedure.

Returns

A handle of type XtActionHookId that can be passed to XtRemoveActionHook() to unregister the action hook procedure. 

Availability

Release 4 and later. 

Description

XtAppAddActionHook() registers a procedure proc to be called by the translation manager with data client_data just before any action procedure is dispatched in the application context app.  Any number of action hook procedure/data pairs may be registered in an application context, and they will be called in reverse order of registration (i.e., the most recently registered will be the first called).  See XtActionHookProc(2) for an explanation of how to write an action hook procedure. 

Usage

Action hooks can be used to record user actions for later playback using XtCallActionProc().  This is one way to implement keyboard macros.  An action hook procedure can be unregistered with XtRemoveActionHook(). 

Structures

XtActionHookId is an opaque type. 

See Also

XtRemoveActionHook(1),
XtActionHookProc(2). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates