Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
XmGetVisibility(3)	    Library Functions Manual	      XmGetVisibility(3)

NAME
     XmGetVisibility -- A function that determines if a widget is visible

SYNOPSIS
     #include <Xm/Xm.h>
     XmVisibility XmGetVisibility(
     Widget widget);

DESCRIPTION
     XmGetVisibility  returns  the visibility state of the specified widget.  It
     checks to see if some part of the widget's rectangular area  is  unobscured
     by the widget's ancestors, or some part of the widget's rectangular area is
     inside  the  work	window	(but  possibly	outside  the  clip  window) of a
     ScrolledWindow whose XmNscrollingPolicy is XmAUTOMATIC  and  whose  XmNtra-
     verseObscuredCallback is not NULL.

     XmGetVisibility does not check to see if widget is obscured by its siblings
     or  by  siblings  of  its	ancestors. Consequently, XmGetVisibility returns
     XmVISIBILITY_UNOBSCURED for widgets which are completely or partially  cov-
     ered by one or more siblings of widget by one or more siblings of ancestors
     of widget.

     When  a  widget  which is unrealized is being queried, it is indicated that
     the widget is fully obscured.  If an application unmaps a widget  that  has
     its  XmNmappedWhenManaged	resource  set to True, the return value is unde-
     fined.  When a widget which is unmanaged is being queried, it is  indicated
     that the widget is fully obscured.

     widget    Specifies the ID of the widget

RETURN
     Returns one of the following values:

     XmVISIBILITY_UNOBSCURED
	       Indicates  that	the  widget is mapped, not obscured, and is com-
	       pletely visible on the screen.

     XmVISIBILITY_PARTIALLY_OBSCURED
	       Indicates that the widget is mapped, and is not completely  visi-
	       ble on the screen (partially obscured).

     XmVISIBILITY_FULLY_OBSCURED
	       Indicates that the widget is not at all visible on the screen.

RELATED
     XmIsTraversable(3), XmManager(3), and XmProcessTraversal(3).

							      XmGetVisibility(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmGetVisibility&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help