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(
          Widget menu);

     VERSION
          This page documents Motif 2.1.

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