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

FreeBSD Manual Pages

  
 
  

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 unob-
       scured by the widget's ancestors, or some part of the widget's  rectan-
       gular  area  is	inside	the work window	(but possibly outside the clip
       window) of a ScrolledWindow whose XmNscrollingPolicy is XmAUTOMATIC and
       whose XmNtraverseObscuredCallback is not	NULL.

       XmGetVisibility does not	check to see if	widget is obscured by its sib-
       lings or	by siblings of its  ancestors.	Consequently,  XmGetVisibility
       returns	XmVISIBILITY_UNOBSCURED	 for  widgets  which are completely or
       partially covered by one	or more	siblings of widget by one or more sib-
       lings 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	undefined.  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
		 completely visible on the screen.

       XmVISIBILITY_PARTIALLY_OBSCURED
		 Indicates that	the widget is mapped, and  is  not  completely
		 visible 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+14.3.quarterly>

home | help