XSetTransientForHint() XSetTransientForHint()
Name
XSetTransientForHint - set the XA_WM_TRANSIENT_FOR property for a window.
Synopsis
XSetTransientForHint(display, w, prop_window)
Display *display;
Window w;
Window prop_window;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the window ID, normally of a dialog box popup.
prop_window
Specifies the window ID that the XA_WM_TRANSIENT_FOR property is to be set to. This is usually the main window of the applica-
tion.
Description
XSetTransientForHint() sets the XA_WM_TRANSIENT_FOR property of the specified window. This should be done when the window w is a temporary
child (for example, a dialog box) and the main top-level window of its application is prop_window. Some window managers may use this
information to unmap an application's dialog boxes (for example, when the main application window gets iconified).
For more information, see Volume One, Chapter 12, Interclient Communication.
Errors
BadAlloc
BadWindow
See Also
XFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(),
XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetWMHints(), XSet-
ZoomHints(), XStoreName().
Xlib - Window Manager Hints XSetTransientForHint()