NAME

XtRemoveAllCallbacks − delete all procedures from a callback list. 

SYNOPSIS

void XtRemoveAllCallbacks(object, callback_name)
    Widget object;
    String callback_name;

Inputs

objectSpecifies the object whose callbacks are to be deleted; may be of class Object or any subclass thereof. 

callback_name
Specifies the name of the callback list from which procedures are to be removed.

DESCRIPTION

XtRemoveAllCallbacks() removes all callback procedures registered on the callback list named by callback_name in the object object.  It also frees all memory allocated by the Intrinsics for that callback list. 

USAGE

This is a dangerous function to call, because callbacks that you are unaware of may have been registered on any list of your object.  Simply creating a widget may cause special resource converter destructor procedures to be registered on the widget’s destroy callback, for example.  If you use a convenience routine that creates both a dialog shell and the dialog child widget, as a further example, that convenience routine may register a destroy callback on the child so that the shell will be automatically destroyed if the child is destroyed. 

In general, you should use XtRemoveCallback() to remove specified procedure/data pairs that you have registered on a list.  You can also use XtRemoveCallbacks() to remove an array of procedure/data pairs. 

SEE ALSO

XtAddCallbackUNIX SYSTEM V/68, XtAddCallbacksUNIX SYSTEM V/68, XtCallCallbacksUNIX SYSTEM V/68, XtRemoveCallbackUNIX SYSTEM V/68, XtRemoveCallbacksUNIX SYSTEM V/68.