NAME

XRemoveFromSaveSet − remove a window from the client’s save-set. 

Synopsis

XRemoveFromSaveSet(display, w)
Display *display;
Window w;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the window you want to remove from this client’s save-set.  This window must have been created by a client other than the client making this call. 

Description

XRemoveFromSaveSet() removes a window from the save-set of the calling application.  The save-set is a safety net for windows that have been reparented by the window manager, usually to provide a shadow or other background for each window.  When the window manager dies unexpectedly, the windows in the save-set are reparented to their closest living ancestor, so that they remain alive.  This call is not necessary when a window is destroyed since destroyed windows are automatically removed from the save-set.  Therefore, many window managers get away without ever calling XRemoveFromSaveSet().  See Volume One, Chapter 14, Window Management, for more information about save-sets. 

Errors

BadMatchw not created by some other client. 

BadWindow

See Also

XAddToSaveSet(), XChangeSaveSet(). 

Copyright O’Reilly & Assoc.  —