1XmGetTearOffControl(library call)            XmGetTearOffControl(library call)
2
3
4

NAME

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

SYNOPSIS

10       #include <Xm/RowColumn.h>
11       Widget XmGetTearOffControl(
12       Widget menu);
13

DESCRIPTION

15       XmGetTearOffControl provides the application with the means for obtain‐
16       ing the widget ID of the internally created tear-off control in a tear-
17       off menu.
18
19       RowColumn creates a tear-off control for a  PulldownMenu  or  PopupMenu
20       when   the   XmNtearOffModel   resource   is   initialized  or  set  to
21       XmTEAR_OFF_ENABLED.  The tear-off control is a widget that  appears  as
22       the first element in the menu.  The user tears off the menu by means of
23       mouse or keyboard events in the tear-off control.
24
25       The tear-off control has Separator-like behavior.  Once the application
26       has  obtained  the  widget  ID  of  the  tear-off  control,  it can set
27       resources to specify the appearance of the control.  The application or
28       user  can also set these resources in a resource file by using the name
29       of the control, which is TearOffControl.  For a list of  the  resources
30       the application or user can set, see XmRowColumn(3).
31
32       menu      Specifies the widget ID of the RowColumn PulldownMenu or Pop‐
33                 upMenu
34
35       For more information on tear-off menus and  a  complete  definition  of
36       RowColumn and its associated resources, see XmRowColumn(3).
37

RETURN

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

44       XmRowColumn(3).
45
46
47
48                                             XmGetTearOffControl(library call)
Impressum