NAME

       XmGetVisibility — A function that determines if a widget is visible "XmGetVisibility"

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 XmNtraverseObscuredCallback 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 covered 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 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)