XGetTransientForHint() XGetTransientForHint()
Name
XGetTransientForHint - get the XA_WM_TRANSIENT_FOR property of a window.
Synopsis
Status XGetTransientForHint(display, w, prop_window_return)
Display *display;
Window w;
Window *prop_window_return;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the ID of the window to be queried.
prop_window_return
Returns the window contained in the XA_WM_TRANSIENT_FOR property of the specified window.
Returns
Zero on failure, non-zero on success.
Description
XGetTransientForHint() obtains the XA_WM_TRANSIENT_FOR property for the specified window. XGetTransientForHint() is normally used by a
window manager. This property should be set for windows that are to appear only temporarily on the screen, such as pop-up dialog boxes.
The window returned is the main window to which this popup window is related. This lets the window manager decorate the popup window
appropriately.
XGetTransientForHint() returns a Status of zero on failure, and non-zero on success.
For more information on using hints, see Volume One, Chapter 12, Interclient Communication.
Errors
BadWindow
See Also
XFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetWMHints(), XGetZoomHints(), XSet-
ClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(),
XSetZoomHints(), XStoreName().
Xlib - Window Manager Hints XGetTransientForHint()
