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()