xtcallactionproc(3xt) [osf1 man page]

XtCallActionProc(3Xt)													     XtCallActionProc(3Xt)

NAME

       XtCallActionProc - invoke an action procedure directly

SYNOPSIS

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

ARGUMENTS

       Specifies  the  widget  in  which  the  action is to be invoked.  Must be of class core of any subclass thereof.  Specifies the name of the
       action routine.	Specifies the contents of the event passed to the action routine.  Specifies the contents of  the  params  passed  to  the
       action routine.	Specifies the num of entries in params.

DESCRIPTION

       XtCallActionProc  searches  for the named action routine in the same manner and order as translation tables are bound. If found, the action
       routine is invoked with the specified widget, event pointer, and parameters.  It is the responsibility of the caller  to  ensure  that  the
       contents  of event, params, and num_params arguments are appropriate for the specified routine, and if necessary, that the specified widget
       is realized or sensitive. If the named action routine cannot be found, XtCallActionProc generates a warning message and returns.

SEE ALSO

       X Toolkit Intrinsics -- C Language Interface

       Xlib -- C Language X Interface

															     XtCallActionProc(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()