


XmCreateMenuBar(3X)					  XmCreateMenuBar(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmCCrreeaatteeMMeennuuBBaarr - 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eMMeennuuBBaarr ((_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eMMeennuuBBaarr creates an instance of a RowColumn widget of type
  XXmmMMEENNUU__BBAARR and returns the associated	widget ID.  It is provided as a	con-
  venience function for	creating RowColumn widgets configured to operate as a
  MenuBar and is not implemented as a separate widget class.

  The MenuBar widget is	generally used for building a Pulldown menu system.
  Typically, a MenuBar is created and placed along the top of the application
  window, and several CascadeButtons are inserted as the children.  Each of
  the CascadeButtons has a Pulldown MenuPane associated	with it.  These	Pull-
  down MenuPanes must have been	created	as children of the MenuBar.  The user
  interacts with the MenuBar by	using either the mouse or the keyboard.

  The MenuBar displays a 3-D shadow along its border.  The application con-
  trols	the shadow attributes using the	visual-related resources supported by
  XXmmMMaannaaggeerr.

  The MenuBar widget is	 homogeneous in	that it	accepts	only children that
  are a	subclass of XXmmCCaassccaaddeeBBuuttttoonn or XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett.  Attempting to
  insert a child of a different	class results in a warning message.

  If the MenuBar does not have enough room to fit all of its subwidgets	on a
  single line, the MenuBar attempts to wrap the	remaining entries onto addi-
  tional lines if allowed by the geometry manager of the parent	widget.

  _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)

  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CaassccaaddeeBBuuttttoonn((33XX)), XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX)), XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)),
  XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)), XXmmMMaannaaggeerr((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eMMeennuuBBaarr((33XX)).






























































