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(). 

Copyright O’Reilly & Assoc.  —