XSetTransientForHint(3X)                 XSetTransientForHint(3X)



NAME
     XSetTransientForHint, XGetTransientForHint - set and  get  a
     window's WM_TRANSIENT_FOR property

SYNOPSIS
     XSetTransientForHint (display, w, prop-window)
     Display *display;
     Window w;
     Window prop-window;

     Status XGetTransientForHint (display, w,
     prop-window-return)
     Display *display;
     Window w;
     Window *prop-window-return;

DESCRIPTION
     The XSetTransientForHint function sets the
     WM_TRANSIENT_FOR property of the specified window to the
     specified prop-window.

     The XGetTransientForHint function obtains the
     WM_TRANSIENT_FOR property for the specified window.

   Arguments
     These functions accept the following arguments:

     display Specifies the connection to the X server.

     w       Specifies the window ID.

     prop-window
             Specifies the window ID to which the
             WM_TRANSIENT_FOR property is to be set.

     prop-window-return
             Returns the WM_TRANSIENT_FOR property of the speci-
             fied window.

   Properties
     These functions use the following property:

     WM_TRANSIENT_FOR
             Specifies the window ID of another top-level window.
             When WM_TRANSIENT_FOR is set, window managers can
             decide whether to put a close box or border around
             the window. A dialog box is an example of a window
             that has WM_TRANSIENT_FOR set.

ERRORS
     BadAlloc
             The server failed to allocate the requested resource



November, 1990                                                  1

XSetTransientForHint(3X)                 XSetTransientForHint(3X)



             or server memory.

     BadWindow
             A value for a Window argument does not name a de-
             fined window.

     The XSetTransientForHint function can generate
     BadAlloc and BadWindow errors.

     The XGetTransientForHint function can generate a BadWindow
     error.

SEE ALSO
     XAllocClassHint(3X), XAllocIconSize(3X),
     XAllocSizeHints(3X), XAllocWMHints(3X), XSetCommand(3X),
     XSetTextProperty(3X), XSetWMClientMachine(3X),
     XSetWMColormapWindows(3X), XSetWMIconName(3X),
     XSetWMName(3X), XSetWMProperties(3X), XSetWMProtocols(3X),
     XStringListToTextProperty(3X)

     Xlib - C Language Interface



































2                                                  November, 1990