


XmVaCreateSimpleOptionMenu(3X)		       XmVaCreateSimpleOptionMenu(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu - A RowColumn widget convenience creation func-
  tion

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eOOppttiioonnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _o_p_t_i_o_n__l_a_b_e_l,
	    _o_p_t_i_o_n__m_n_e_m_o_n_i_c, _b_u_t_t_o_n__s_e_t, _c_a_l_l_b_a_c_k, _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;;
       XXmmSSttrriinngg	 _o_p_t_i_o_n__l_a_b_e_l;;
       KKeeyySSyymm	 _o_p_t_i_o_n__m_n_e_m_o_n_i_c;;
       iinntt	 _b_u_t_t_o_n__s_e_t;;
       XXttCCaallllbbaacckkPPrroocc_c_a_l_l_b_a_c_k;;

DESCRIPTION
  XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu creates an	instance of a RowColumn	widget of
  type XXmmMMEENNUU__OOPPTTIIOONN and returns the associated	widget ID.  This routine uses
  the ANSI C variable-length argument list (varargs) calling convention.

  This routine creates an OptionMenu and its Pulldown submenu containing
  PushButtonGadget or CascadeButtonGadget children.  The name of each button
  is button__n, where _n is an integer from 0 to one minus the number of but-
  tons in the menu.  The name of each separator	is separator__n,	where _n	is an
  integer from 0 to one	minus the number of separators in the menu.  Buttons
  and separators are named and created in the order in which they are speci-
  fied 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

  _o_p_t_i_o_n__l_a_b_e_l
	 Specifies the label string to be used on the left side	of the
	 OptionMenu.

  _o_p_t_i_o_n__m_n_e_m_o_n_i_c
	 Specifies a keysym for	a key that, when pressed by the	user, posts
	 the associated	Pulldown MenuPane.

  _b_u_t_t_o_n__s_e_t
	 Specifies which PushButtonGadget is initially set.  The value is the
	 integer _n that	corresponds to the _nth PushButtonGadget	specified in
	 the variable portion of the argument list.  Only a PushButtonGadget
	 can be	set, and only PushButtonGadgets	are counted in determining
	 the integer _n.	 The first PushButtonGadget is number 0.

  _c_a_l_l_b_a_c_k
	 Specifies a callback procedure	to be called when a button is
	 activated.  This callback function is added to	each button after
	 creation as the button's XXmmNNaaccttiivvaatteeCCaallllbbaacckk.	The callback function
	 is called when	a button is activated, and the button number is
	 returned in the _c_l_i_e_n_t__d_a_t_a field.

  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aPPUUSSHHBBUUTTTTOONN
	 This is followed by four additional arguments.	 The set specifies
	 one button in the OptionMenu's	Pulldown submenu and some of its
	 resource values.  The button created is a PushButtonGadget.  Follow-
	 ing are the additional	four 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.

	 _a_c_c_e_l_e_r_a_t_o_r
		 The accelerator, of type String.

	 _a_c_c_e_l_e_r_a_t_o_r__t_e_x_t
		 The accelerator text, of type XmString.

  XXmmVVaaSSEEPPAARRAATTOORR
	 This is followed by no	additional arguments.  It specifies one
	 separator in the OptionMenu's Pulldown	submenu.

  XXmmVVaaDDOOUUBBLLEE__SSEEPPAARRAATTOORR
	 This is followed by no	additional arguments.  It specifies one
	 separator in the OptionMenu's Pulldown	submenu.  The separator	type
	 is XXmmDDOOUUBBLLEE__LLIINNEE.

  _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 Pulldown	submenu.

  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	Pulldown submenu.  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.

  The user can specify resources in a resource file for	the automatically
  created widgets and gadgets of an OptionMenu.	 The following list identi-
  fies the names of these widgets (or gadgets) and the associated OptionMenu
  areas.

    oo++  Option Menu Label Gadget-"OptionLabel"

    oo++  Option Menu Cascade Button-"OptionButton"


  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eOOppttiioonnMMeennuu((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eOOppttiioonnMMeennuu((33XX)),	and XXmmRRoowwCCoolluummnn((33XX)).





















































