hpux man page for xgettransientforhint

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