


XmCreatePopupMenu(3X)					XmCreatePopupMenu(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmCCrreeaatteePPooppuuppMMeennuu - A	RowColumn widget convenience creation function

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mCCrreeaatteePPooppuuppMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
       WWiiddggeett	 _p_a_r_e_n_t;;
       SSttrriinngg	 _n_a_m_e;;
       AArrggLLiisstt	 _a_r_g_l_i_s_t;;
       CCaarrddiinnaall	 _a_r_g_c_o_u_n_t;;

DESCRIPTION
  XXmmCCrreeaatteePPooppuuppMMeennuu creates an instance	of a RowColumn widget of type
  XXmmMMEENNUU__PPOOPPUUPP and returns the associated widget ID.  When using this func-
  tion to create the Popup MenuPane, a MenuShell widget	is automatically
  created as the parent	of the MenuPane.  The parent of	the MenuShell widget
  is the widget	indicated by the _p_a_r_e_n_t	parameter.

  XXmmCCrreeaatteePPooppuuppMMeennuu is provided	as a convenience function for creating
  RowColumn widgets configured to operate as Popup MenuPanes and is not
  implemented as a separate widget class.

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

  The Popup MenuPane 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 MenuPane,
  the MenuShell	is automatically created as the	real parent of the MenuPane.
  If the application does not use this convenience function to create the
  RowColumn to function	as a Popup MenuPane, it	is the application's respon-
  sibility to create the MenuShell widget.

  To access the	PopupMenu, the application must	first position the widget
  using	the XXmmMMeennuuPPoossiittiioonn function and	then manage it using XXttMMaannaaggeeCChhiilldd.

  _p_a_r_e_n_t Specifies the parent widget ID

  _n_a_m_e	 Specifies the name of the created widget

  _a_r_g_l_i_s_tSpecifies the argument	list

  _a_r_g_c_o_u_n_t
	 Specifies the number of attribute/value pairs in the argument list
	 (_a_r_g_l_i_s_t)

  Popup	MenuPanes support tear-off capabilities	for tear-off menus through
  XXmmRRoowwCCoolluummnn resources.  For 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 RowColumn	widget ID.


RELATED	INFORMATION
  XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)), XXmmMMeennuuPPoossiittiioonn((33XX)), XXmmMMeennuuSShheellll((33XX)),
  XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)).































































