XmGetTearOffControl(3X)XmGetTearOffControl(3X)NAMEXmGetTearOffControl — A RowColumn function that obtains the widget ID
for the tear-off control in a menu
SYNOPSIS
#include <Xm/RowColumn.h>
Widget XmGetTearOffControl (menu) Widget menu;
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTIONXmGetTearOffControl provides the application with the means for obtain‐
ing 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(3X). 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(3X).
RETURN VALUE
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 INFORMATIONXmRowColumn(3X).
XmGetTearOffControl(3X)