


XmVaCreateSimpleMenuBar(3X)			  XmVaCreateSimpleMenuBar(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmVVaaCCrreeaatteeSSiimmpplle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mVVaaCCrreeaatteeSSiimmpplleeMMeennuuBBaarr ((_p_a_r_e_n_t, _n_a_m_e,	_a_r_g...))
       WWiiddggeett	 _p_a_r_e_n_t;;
       SSttrriinngg	 _n_a_m_e;;

DESCRIPTION
  XXmmVVaaCCrreeaatteeSSiimmpplle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.  This routine uses the
  ANSI C variable-length argument list (varargs) calling convention.

  This routine creates a MenuBar and its CascadeButtonGadget children.	The
  name of each button is button__n, where _n is an integer from 0	to one minus
  the number of	buttons	in the menu.  Buttons are named	and created in the
  order	in which they are specified in the variable portion of the argument
  list.

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

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

  The variable portion of the argument list consists of	groups of arguments.
  The first argument in	each group is a	constant or a string and determines
  which	arguments follow in that group.	 The last argument in the list must
  be NULL.  Following are the possible first arguments in each group of
  varargs:

  XXmmVVaaCCAASSCCAADDEEBBUUTTTTOONN
	 This is followed by two additional arguments.	The set	specifies one
	 button	in the MenuBar and some	of its resource	values.	 Following
	 are the additional two	arguments, in this order:

	 _l_a_b_e_l	 The label string, of type XmString.

	 _m_n_e_m_o_n_i_c
		 The mnemonic, of type KeySym.

  _r_e_s_o_u_r_c_e__n_a_m_e
	 This is followed by one additional argument, the value	of the
	 resource, of type XtArgVal.  The pair specifies a resource and	its
	 value for the RowColumn widget.

  XXttVVaaTTyyppeeddAArrgg
	 This is followed by four additional arguments.	 The set specifies a
	 resource and its value	for the	RowColumn widget.  A resource type
	 conversion is performed if necessary.	Following are the additional
	 four arguments, in this order:

	 _n_a_m_e	 The resource name, of type String.

	 _t_y_p_e	 The type of the resource value	supplied, of type String.

	 _v_a_l_u_e	 The resource value (or	a pointer to the resource value,
		 depending on the type and size	of the value), of type
		 XtArgVal.

	 _s_i_z_e	 The size of the resource value	in bytes, of type int.

  XXttVVaaNNeesstteeddLLiisstt
	 This is followed by one additional argument of	type XtVarArgsList.
	 This argument is a nested list	of varargs returned by XXttVVaa--
	 CCrreeaatteeAArrggssLLiisstt.

  For more information on variable-length argument lists, see the X Toolkit
  Intrinsics documentation.

  A number of resources	exist specifically for use with	this and other simple
  menu creation	routines.  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eMMeennuuBBaarr((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((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)), and
  XXmmRRoowwCCoolluummnn((33XX)).











































