X Version 11 (Release 6.1)

XChangeSaveSet(X3xlib)

XChangeSaveSet -- change a client's save set

Synopsis

   XChangeSaveSet(display, w, change_mode)
         Display *display;
         Window w;
         int change_mode;
   
   XAddToSaveSet(display, w)
         Display *display;
         Window w;
   

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

Arguments

change_mode: Specifies the mode. You can pass SetModeInsert or SetModeDelete.
display: Specifies the connection to the X server.
w: Specifies the window that you want to add or delete from the client's save-set.

Description

Depending on the specified mode, XChangeSaveSet either inserts or deletes the specified window from the client's save-set. The specified window must have been created by some other client, or a ``BadMatch'' error results.

XChangeSaveSet can generate ``BadMatch'', ``BadValue'', and ``BadWindow'' errors.

The XAddToSaveSet function adds the specified window to the client's save-set. The specified window must have been created by some other client, or a ``BadMatch'' error results.

XAddToSaveSet can generate ``BadMatch'' and ``BadWindow'' errors.

The XRemoveFromSaveSet function removes the specified window from the client's save-set. The specified window must have been created by some other client, or a ``BadMatch'' error results.

XRemoveFromSaveSet can generate ``BadMatch'' and ``BadWindow'' errors.

Diagnostics

``BadMatch'': Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request.
``BadValue'': Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error.
``BadWindow'': A value for a Window argument does not name a defined Window.

References

XReparentWindow(X3xlib)
Xlib - C Language X Interface