XtRemoveCaB(3x) — HP-UX ANSI C A.10.11

NAME

XtRemoveCallbacks − remove a list of callbacks from a callback list.

Synopsis

void XtRemoveCallbacks(object, callback_name, callbacks)

    Widget object;
    String callback_name;
    XtCallbackList callbacks;

Inputs

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

callback_name
Specifies the callback list from which the callbacks are to be removed.

callbacksSpecifies a NULL-terminated array of procedure/data pairs to be removed from the callback list.

Description

XtRemoveCallbacks() removes each of the procedure/data pairs in callbacks from the callback list named by callback_name of object object. Each callback is removed only if it exactly matches a procedure/data pair registered on the callback list. If a procedure/data pair in the callbacks array does not match a pair on the callback list, XtRemoveCallbacks() does nothing with that array element and does not generate a warning message. Because there is not an argument that specifies the number of elements in the callbacks array, the last element of this array should be a XtCallbackRec structure with NULL in both fields.

Usage

Because XtRemoveCallbacks() requires the caller to allocate and initialize an array of procedure/data pairs, it may often be easier to simply call XtRemoveCallback() repeatedly. The exception is when a statically initialized array is used to both add and remove callbacks.

Structures

typedef struct _XtCallbackRec {
XtCallbackProc callback;
XtPointer closure;
} XtCallbackRec, *XtCallbackList;

Museum