NAME

XtCallCallbacks − execute the procedures on a widget’s named callback list. 

Synopsis

void XtCallCallbacks(object, callback_name, call_data)

    Widget object;
    String callback_name;
    XtPointer call_data;

Inputs

objectSpecifies the object; may be of class Object or any subclass thereof. 

callback_name
Specifies the resource name of the callback list to be executed.

call_dataSpecifies the value to pass to each callback procedure as its third argument. 

Description

XtCallCallbacks() calls the procedures registered on the callback list named by callback_name on the widget or object object.  It invokes each procedure with object as the first argument, the data registered with each procedure as the second argument, and call_data as the third argument. 

Usage

XtCallCallbacks() should only be called by widgets and objects; applications will never need to call it.  XtCallCallbackList() calls the procedures on a callback list specified directly as an XtCallbackList.  This 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 registered 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. 

See Also

XtAddCallback(1), XtCallCallbackList(1). 

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