xtcallactionproc(3) [x11r4 man page]
XtCallActionProc(3) XT FUNCTIONS XtCallActionProc(3) NAME
XtCallActionProc - invoke an action procedure directly SYNTAX
void XtCallActionProc(Widget widget, String action, XEvent* event, String* params, Cardinal num_params); ARGUMENTS
widget Specifies the widget in which the action is to be invoked. Must be of class core of any subclass thereof. action Specifies the name of the action routine. event Specifies the contents of the event passed to the action routine. params Specifies the contents of the params passed to the action routine. num_params 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 con- tents 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 X Version 11 libXt 1.0.5 XtCallActionProc(3)
Check Out this Related Man Page
XtActionHookProc() XtActionHookProc() Name XtActionHookProc - interface definition for action hook procedure. Synopsis typedef void (*XtActionHookProc)(Widget, XtPointer, String, XEvent*, String*, Cardinal*); Widget w; XtPointer client_data; String action_name; XEvent* event; String* params; Cardinal* num_params; Inputs w Specifies the widget whose action is about to be dispatched. client_data Specifies data that was registered with this procedure in a call to XtAppAddActionHook(). action_name Specifies the name of the action to be dispatched. event Specifies the event argument that will be passed to the action routine. params Specifies the action parameters that will be passed to the action routine. num_params Specifies the number of elements in params. Availability Release 4 and later. Description An XtActionHookProc registered with XtAppAddActionHook() will be called just before any action procedure is invoked by the Translation Man- ager. client_data is whatever data was registered with the action hook procedure in the call to XtAppAddActionHook(). action_name is the name of the action procedure that is about to be invoked. It is the name the action procedure was registered with, and can be used in a call to XtCallActionProc(). The w, event, params, and num_params arguments are the arguments that will be passed directly to the action procedure. Action hooks should not modify any of the data pointed to by the arguments other than the client_data argument. Usage One use of an XtActionHookProc is to record the arguments passed to each action so that user actions are recorded for later playback using XtCallActionProc(). This is one way to implement keyboard macros. See Also XtAppAddActionHook(1), XtCallActionProc(1), XtRemoveActionHook(1), XtActionProc(2). Xt - Translations and Actions XtActionHookProc()