RemoveCBs(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

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;