XtCallCallbackList() XtCallCallbackList()
Name
XtCallCallbackList - execute the procedures in a callback list, specifying the callback list by address.
Synopsis
void XtCallCallbackList(object, callbacks, call_data)
Widget object;
XtCallbackList callbacks;
XtPointer call_data;
Inputs
object Specifies the object which contains the callback list; may be of class Object or any subclass thereof.
callbacks Specifies the callback list to be invoked.
call_data Specifies data to pass to each of the callback procedures in the list as their call_data arguments.
Availability
Release 4 and later.
Description
XtCallCallbackList() calls the procedures on the callbacks callback list. It invokes each procedure with object as the first argument, the
data registered with the procedure as the second argument and call_data as the third argument.
callbacks must be of type XtCallbackList, and must be a widget or object resource of resource type XtRCallback.
Usage
XtCallCallbackList() should only be called by widgets and objects; applications will never need to call it.
XtCallCallbacks() calls the procedures on a callback list specified by name. XtCallCallbackList() is generally a little faster because it
does not have to look up the callback list by name.
The call_data argument is untyped value. The caller must be sure to pass correctly initialized data of the type expected by callbacks reg-
istered on the specified callback list. This type may be an int, or some other type that fits in 32 bits, but is often a pointer to a
structure.
Widgets maintain XtCallbackLists in a compiled internal form, for this reason, you cannot call XtCallCallbackList() on a statically ini-
tialized array of XtCallbackRec or any other XtCallbackList that is not a widget or object resource.
See Also
XtAddCallback(1), XtCallCallbacks(1).
Xt - Callbacks XtCallCallbackList()