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


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004