XChangeSaveSet(3X) — X Version 11

NAME

XChangeSaveSet, XAddToSaveSet, XRemoveFromSaveSet − change a client’s save set

SYNTAX

XChangeSaveSet(display, w, change_mode)
      Display ∗display;
      Window w;
      int change_mode;

XAddToSaveSet(display, w_add)
Display ∗display;
Window w_add;

XRemoveFromSaveSet(display, w_remove)
Display ∗display;
Window w_remove;

ARGUMENTS

change_mode
Specifies the mode. You can pass one of SetModeInsert or SetModeDelete. If SetModeInsert, XChangeSaveSet adds the window to this client’s save-set. If SetModeDelete, XChangeSaveSet deletes the window from this client’s save-set.

displaySpecifies the connection to the X server.

w_addSpecifies the window ID of the window whose children you want to add to the client’s save-set.

w_removeSpecifies the window ID of the window whose children you want to remove from the client’s save-set.

DESCRIPTION

Depending on the constant you passed to the change_mode argument, the XChangeSaveSet function either adds or removes a subwindow from the client’s save-set. .PN XChangeSaveSet can generate BadMatch, BadValue, and BadWindow errors.

The XAddToSaveSet function adds the children of the specified window to the client’s save-set. .PN XAddToSaveSet can generate BadMatch and BadWindow errors.

The XRemoveFromSaveSet function removes the children of the specified window from the client’s save-set. .PN 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.

Museum