manpagez: man pages & more
man XmGetTearOffControl(3)
Home | html | info | man
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 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(3).

       menu      Specifies the widget ID of the RowColumn PulldownMenu or Pop-
                 upMenu

       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)

openMotif 2.3.1 - Generated Sun Nov 30 16:21:31 CST 2008
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.