xtappaddactionhook(3xt) [redhat man page]

XtAppAddActionHook(3Xt) 					   XT FUNCTIONS 					   XtAppAddActionHook(3Xt)

NAME

       XtAppAddActionHook, XtRemoveActionHook - register an action hook procedure

SYNTAX

       XtActionHookId XtAppAddActionHook(app_context, proc, client_data)
	     XtAppContext app_context;
	     XtActionHookProc proc;
	     XtPointer client_data;

       void XtRemoveActionHook(id)
	     XtActionHookId id;

ARGUMENTS

       app_context
		 Specifies the application context.

       proc	 Specifies the action hook procedure.

       num_args  Specifies the application-specific data to be passed to the action hook.

DESCRIPTION

       XtAppAddActionHook adds the specified procedure to the front of a list maintained in the application context. In the future, when an action
       routine is about to be invoked for any widget in this application context, either through the translation manager or via XtCallActionProc,
       the action hohok procedures will be called in reverse order of registration jut prior to invoking the action routine.

       Action hook procedures are removed automatically and the XtActionHookId s destroyed when the application context in which they were added
       is destroyed.

       XtRemoveActionHook removes the specified action hook procedure from the list in which it was registered.

SEE ALSO

       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    Release 6.6 					   XtAppAddActionHook(3Xt)

XtCallActionProc()														XtCallActionProc()

Name
  XtCallActionProc - explicitly invoke a named action procedure.

Synopsis
  void XtCallActionProc(widget, action, event, params, num_params)
	   Widget widget;
	   String action;
	   XEvent *event;
	   String *params;
	   Cardinal num_params;

Inputs
  widget    Specifies the widget in which the action is to be invoked; must be of class Core or any subclass thereof.

  action    Specifies the name of the action routine.

  event     Specifies the event to pass to the action procedure.

  params    Specifies parameters to pass to the action procedure.

  num_params
	    Specifies the number of elements in the params array.

Description
  XtCallActionProc()  looks  up the action procedure named action and invokes it, passing widget, event, params, and num_params as arguments.
  Before calling the named action, XtCallActionProc() invokes any action hook procedures that have been registered with XtAppAddActionHook().

  It is the responsibility of the caller to ensure that the contents of the event, params, and num_params arguments are appropriate  for  the
  specified  action routine and, if necessary, that the specified widget is realized and/or sensitive.	If the named action routine cannot be
  found, XtCallActionProc() generates a warning message and returns.

  When searching for the action procedure, XtCallActionProc() looks in the following places:

  o  The widget's class and all superclass action tables, in subclass-to-superclass order.

  o  The parent's class and all superclass action tables, in subclass-to-superclass order, then on up the ancestor tree.

  o  The action tables registered with XtAppAddActions() and XtAddActions() from the most recently added table to the oldest table.

See Also
  XtAppAddActionHook(1), XtRemoveActionHook(1),
  XtActionHookProc(2).

Xt - Translations and Actions													XtCallActionProc()