XChangeSaveSet(3X)                             XChangeSaveSet(3X)



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

SYNOPSIS
     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;

DESCRIPTION
     Depending on the value of change-mode, the XChangeSaveSet
     function either adds or removes a window from the client's
     save set.  A window manager is usually the client, and the
     save-set consists of other client's top-level windows that
     have been reparented by the window manager. If such windows
     are not made part of the window manager's save set, they
     would be destroyed if the window manager were to die unex-
     pectedly.  When the window manager dies, windows that are
     part of the save set are automatically reparented to their
     closest existing ancestor and remapped.  The specified win-
     dow must have been created by some other client, or a Bad-
     Match error results.

     The XAddToSaveSet function adds the specified window to the
     client's save set.  The window must have been created by
     some other client, or a BadMatch error results.

     The XRemoveFromSaveSet function removes the specified window
     from the client's save set.  The window must have been
     created by some other client, or a BadMatch error results.

   Arguments
     These functions accept the following arguments:

     change-mode
             Specifies the mode.  You can pass either
             SetModeInsert or SetModeDelete.  If you use
             SetModeInsert, XChangeSaveSet adds the window to
             this client's save set.  If you use SetModeDelete,
             XChangeSaveSet deletes the window from this client's
             save set.

     display Specifies the connection to the X server.



November, 1990                                                  1

XChangeSaveSet(3X)                             XChangeSaveSet(3X)



     w-add   Specifies the ID of the window whose children you
             want to add to the client's save set.

     w-remove
             Specifies the ID of the window whose children you
             want to remove from the client's save set.

ERRORS
     BadMatch
             An argument or pair of arguments has the correct
             type and range but fails to match in some other re-
             quired way.

     BadValue
             A numeric value falls outside the range of values
             accepted by the request.  Unless a range is speci-
             fied 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 de-
             fined window.

     XChangeSaveSet can generate BadMatch, BadValue, and BadWin-
     dow errors.

     XAddToSaveSet and XRemoveFromSaveSet can generate BadMatch
     and BadWindow errors.

SEE ALSO
     XReparentWindow(3X),

     Xlib - C Language Interface





















2                                                  November, 1990