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
displaySpecifies a connection to an X server; returned from XOpenDisplay().
wSpecifies 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.
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 nonzero on success. For more information on using hints, see Volume One, Chapter 10, Interclient Communication.
Errors
BadWindow
See Also
XGetClassHint(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetWMHints(), XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(), XSetZoomHints(),
Copyright O’Reilly & Assoc. —