---
name: "XmGetVisibility"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmGetVisibility"
---

# XmGetVisibility(3)

A function that determines if a widget is visible

## 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 **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)](/XmIsTraversable/3.md), [**XmManager**(3)](/XmManager/3.md), and [**XmProcessTraversal**(3)](/XmProcessTraversal/3.md).