xmgettearoffcontrol(3) [centos man page]

XmGetTearOffControl(library call)										 XmGetTearOffControl(library call)

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).

       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).

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).

														 XmGetTearOffControl(library call)

XmCreatePopupMenu(library call) 										   XmCreatePopupMenu(library call)

NAME

       XmCreatePopupMenu -- A RowColumn widget convenience creation function

SYNOPSIS

       #include <Xm/RowColumn.h>
       Widget XmCreatePopupMenu(
       Widget parent,
       String name,
       ArgList arglist,
       Cardinal argcount);

DESCRIPTION

       XmCreatePopupMenu  creates  an instance of a RowColumn widget of type XmMENU_POPUP and returns the associated widget ID. When this function
       is used to create the Popup menu pane, a MenuShell widget is automatically created as the parent of the	menu  pane.   The  parent  of  the
       MenuShell widget is the widget indicated by the parent parameter.

       XmCreatePopupMenu is provided as a convenience function for creating RowColumn widgets configured to operate as Popup menu panes and is not
       implemented as a separate widget class.

       The PopupMenu is used as the first menu pane within a PopupMenu system; all other menu panes are of the Pulldown type. A  Popup	menu  pane
       displays a 3-D shadow, unless the feature is disabled by the application.  The shadow appears around the edge of the menu pane.

       The  Popup  menu pane must be created as the child of a MenuShell widget in order to function properly when it is incorporated into a menu.
       If the application uses this convenience function for creating a Popup menu pane, the MenuShell is automatically created as the real parent
       of  the	menu pane.  If the application does not use this convenience function to create the RowColumn to function as a Popup menu pane, it
       is the application's responsibility to create the MenuShell widget.

       To access the PopupMenu, the application must first position the widget using the XmMenuPosition function and then manage it  using  XtMan-
       ageChild.

       parent	 Specifies the parent widget ID

       name	 Specifies the name of the created widget

       arglist	 Specifies the argument list

       argcount  Specifies the number of attribute/value pairs in the argument list (arglist)

       Popup  menu  panes  support tear-off capabilities for tear-off menus through XmRowColumn resources.  For a complete definition of RowColumn
       and its associated resources, see XmRowColumn(3).

RETURN

       Returns the RowColumn widget ID.

RELATED

       XmCreateSimplePopupMenu(3), XmMenuPosition(3), XmMenuShell(3), XmRowColumn(3), and XmVaCreateSimplePopupMenu(3).

														   XmCreatePopupMenu(library call)