XChangeSaveSet()XChangeSaveSet()NameXChangeSaveSet – 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
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the ID of the window whose children you want to add
or remove from the client's save-set; it must have been cre‐
ated by some other client.
change_mode
Specifies the mode. Pass one of these constants: SetModeIn‐
sert (adds the window to this client's save-set) or SetMod‐
eDelete (deletes the window from this client's save-set).
DescriptionXChangeSaveSet() 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 15, Other
Programming Techniques.
Errors
BadMatch w not created by some other client.
BadValue
BadWindow
See AlsoXAddToSaveSet(), XRemoveFromSaveSet().
Xlib - Window Save Set XChangeSaveSet()