XChangeSaveSet(X3xlib) X Version 11 (Release 6.1)
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
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.