hpux man page for xtappaddaca

XtAppAddActionHook()													      XtAppAddActionHook()

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
  app	    Specifies the application context.

  proc	    Specifies 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 proce-
  dure is dispatched in the application context app.  Any number of action hook procedure/data pairs may be registered in an application con-
  text, 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).

Xt - Translations and Actions												      XtAppAddActionHook()