NAME

XChangeSaveSet — add or remove a subwindow from the client’s save-set. 

SYNOPSIS

XChangeSaveSet(display, w, change_mode) Display ∗display; Window w;  int change_mode;

ARGUMENTS

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

wSpecifies the ID of the window whose children you want to add or remove from the client’s save-set; it must have been created by some other client. 

change_mode
Specifies the mode.  Pass one of these constants: SetModeInsert (adds the window to this client’s save-set) or SetModeDelete (deletes the window from this client’s save-set). 

DESCRIPTION

XChangeSaveSet() adds or deletes windows from a client’s save-set.  This client is usually the window manager. 

The save-set of the window manager is a list of other client’s top-level windows which have been reparented.  If the window manager dies unexpectedly, these top-level application windows are children of a window manager window and therefore would normally be destroyed.  The save-set prevents this by automatically reparenting the windows listed in the save-set to their closest existing ancestor, and then remapping them. 

Windows are removed automatically from the save-set by the server when they are destroyed. 

For more information on save-sets, see Volume One, Chapter 13, Other Programming Techniques. 

ERRORS

BadMatchw not created by some other client. 

BadValue

BadWindow

SEE ALSO

XAddToSaveSet(), XRemoveFromSaveSet(). 

Xlib Reference Manual