XmGetTearOffControl(3X) UNIX System V XmGetTearOffControl(3X)
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 (menu)
Widget menu;
VERSION
This page documents version 1.2 of the Motif library.
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 XmTEAROFFENABLED. 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).
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(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 INFORMATION
XmRowColumn(3X).
Page 1 (printed 4/30/98)