Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XmGetTearOffControl(3)	   Library Functions Manual	XmGetTearOffControl(3)

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

       #include	<Xm/RowColumn.h>
       Widget XmGetTearOffControl(
       Widget menu);

       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 re-
       sources 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-

       For more	information on tear-off	menus and  a  complete	definition  of
       RowColumn and its associated resources, see XmRowColumn(3).

       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.




Want to link to this manual page? Use this URL:

home | help