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

# XmGetTearOffControl(3)

A RowColumn function that obtains the widget ID for the tear-off control in a menu

## NAME

**XmGetTearOffControl** — A RowColumn function that obtains the widget ID for the tear-off control in a menu

## SYNOPSIS

```
#include <Xm/RowColumn.h>
Widget XmGetTearOffControl(
Widget menu);
```

## DESCRIPTION

**XmGetTearOffControl** provides the application with the means for obtaining the widget ID of the internally created tear-off control in a tear-off menu.

RowColumn creates a tear-off control for a PulldownMenu or PopupMenu when the **XmNtearOffModel** resource is initialized or set to **XmTEAR\_OFF\_ENABLED**. The tear-off control is a widget that appears as the first element in the menu. The user tears off the menu by means of mouse or keyboard events in the tear-off control.

The tear-off control has Separator-like behavior. Once the application has obtained the widget ID of the tear-off control, it can set resources to specify the appearance of the control. The application or user can also set these resources in a resource file by using the name of the control, which is **TearOffControl**. For a list of the resources the application or user can set, see [**XmRowColumn**(3)](/XmRowColumn/3.md).

- *menu*

  Specifies the widget ID of the RowColumn PulldownMenu or PopupMenu

For more information on tear-off menus and a complete definition of RowColumn and its associated resources, see [**XmRowColumn**(3)](/XmRowColumn/3.md).

## RETURN

Returns the widget ID for the tear-off control, or NULL if no tear-off control exists. An application should not assume that the returned widget will be of any particular class.

## RELATED

[**XmRowColumn**(3)](/XmRowColumn/3.md).