XSetTransientForHint(3) XLIB FUNCTIONS XSetTransientForHint(3)

NAME
       XSetTransientForHint, XGetTransientForHint - set or read a window's
       WMTRANSIENTFOR property

SYNTAX
       int XSetTransientForHint(Display *display, Window w, Window propwin‐
              dow);

       Status XGetTransientForHint(Display *display, Window w, Window
              *propwindowreturn);

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 win‐
                 dow.

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 a nonzero status on success; oth‐
       erwise, it returns a zero status.

       XGetTransientForHint can generate a BadWindow error.

PROPERTIES
       WMTRANSIENTFOR
                 Set by application programs to indicate to the window manager
                 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 Window.

SEE ALSO
       XAllocClassHint(3), XAllocIconSize(3), XAllocSizeHints(3), XAl‐
       locWMHints(3), XSetCommand(3), XSetTextProperty(3), XSetWMClientMa‐
       chine(3), XSetWMColormapWindows(3), XSetWMIconName(3), XSetWMName(3),
       XSetWMProperties(3), XSetWMProtocols(3), XStringListToTextProperty(3)
       Xlib - C Language X Interface



X Version 11                     libX11 1.6.5          XSetTransientForHint(3)