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

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

actionSpecifies the name of the action routine. 

eventSpecifies the event to pass to the action procedure. 

paramsSpecifies 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:

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

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

•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). 
 

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