XtCallCallA(3x) — HP-UX 9.10

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

objectSpecifies the object which contains the callback list; may be of class Object or any subclass thereof.

callbacksSpecifies the callback list to be invoked.

call_dataSpecifies 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 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. Widgets maintain XtCallbackLists in a compiled internal form, for this reason, you cannot call XtCallCallbackList() on a statically initialized array of XtCallbackRec or any other XtCallbackList that is not a widget or object resource.

Museum