1. NAME

XChangeSaveSet, XAddToSaveSet, XRemoveFromSaveSet - change a client's save set

2. SYNTAX

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

3. ARGUMENTS

change_mode 1i Specifies the mode. You can pass .ZN SetModeInsert or .ZN SetModeDelete .

display 1i Specifies the connection to the X server.

w 1i Specifies the window \*(Wi.

4. DESCRIPTION

Depending on the specified mode, .ZN 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 .ZN BadMatch error results.

.ZN XChangeSaveSet can generate .ZN BadMatch , .ZN BadValue , and .ZN BadWindow errors.

The .ZN 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 .ZN BadMatch error results.

.ZN XAddToSaveSet can generate .ZN BadMatch and .ZN BadWindow errors.

The .ZN 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 .ZN BadMatch error results.

.ZN XRemoveFromSaveSet can generate .ZN BadMatch and .ZN BadWindow errors.

5. DIAGNOSTICS

  • .ZN 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.
  • .ZN 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.
  • .ZN BadWindow
     A value for a Window argument does not name a defined Window.

6. SEE ALSO

XReparentWindow(3)
\*(xL