XSetTransientForHint(XS) X Version 11 (Release 5)   XSetTransientForHint(XS)
                                6 January 1993


 Name

    XSetTransientForHint - set or read a window's WM_TRANSIENT_FOR property

 Syntax


    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;


 Arguments


    display        Specifies the connection to the X server.

    w              Specifies the window.

    propwindow    Specifies the window that the WMTRANSIENTFOR property is
                   to be set to.

    propwindowreturn
                   Returns the WMTRANSIENTFOR property of the specified
                   window.

 Description

    The XSetTransientForHint function sets the WMTRANSIENTFOR property of
    the specified window to the specified propwindow.

    XSetTransientForHint can generate ``BadAlloc'' and ``BadWindow'' errors.

    The XGetTransientForHint function returns the WMTRANSIENTFOR property
    for the specified window.  It returns nonzero status on success; other-
    wise it returns a zero status.

    XGetTransientForHint can generate a ``BadWindow'' error.

 Properties


    WMTRANSIENTFOR
                   Set by application programs to indicate to the window man-
                   ager that a transient top-level window, such as a dialog
                   box.

 Diagnostics


    ``BadAlloc''   The server failed to allocate the requested resource or
                   server memory.

    ``BadWindow''  A value for a Window argument does not name a defined Win-
                   dow.

 See also

    XAllocClassHint(XS), XAllocIconSize(XS), XAllocSizeHints(XS),
    XAllocWMHints(XS), XSetCommand(XS), XSetTextProperty(XS), XSetWMClientMa-
    chine(XS), XSetWMColormapWindows(XS), XSetWMIconName(XS), XSetWMName(XS),
    XSetWMProperties(XS), XSetWMProtocols(XS), XStringListToTextProperty(XS)
    Xlib - C Language X Interface