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
displaySpecifies a connection to an X server; returned from XOpenDisplay().
wSpecifies 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 application.
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 10, Interclient Communication.
Errors
BadAlloc
BadWindow
See Also
XGetClassHint(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetWMHints(), XSetZoomHints(),
Copyright O’Reilly & Assoc. —