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.