XChangeSaveSet() XChangeSaveSet()
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
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 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 remap-
ping 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 Also
XAddToSaveSet(), XRemoveFromSaveSet().
Xlib - Window Save Set XChangeSaveSet()
