


XmGetTearOffControl(3X)				      XmGetTearOffControl(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmGGeettTTeeaarrOOffffCCoonnttrrooll -	A RowColumn function that obtains the widget ID	for
  the tear-off control in a menu

SYNOPSIS


  ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
  WWiiddggeett XXmmGGeettTTeeaarrOOffffCCoonnttrrooll ((_m_e_n_u))
       WWiiddggeett	 _m_e_n_u;;

DESCRIPTION
  XXmmGGeettTTeeaarrOOffffCCoonnttrrooll 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 XXmmNNtteeaarrOOffffMMooddeell resource is initialized or set to	XXmmTTEEAARR__OOFFFF__EENNAABBLLEEDD.
  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 XXmmRRoowwCCoolluummnn((33XX)).

  _m_e_n_u	 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 XXmmRRoowwCCoolluummnn((33XX)).

RETURN VALUE
  Returns the widget ID	for the	tear-off control, or NULL if no	tear-off con-
  trol exists.	An application should not assume that the returned widget
  will be of any particular class.

RELATED	INFORMATION
  XXmmRRoowwCCoolluummnn((33XX)).

















