


XmCreatePulldownMenu(3X)			     XmCreatePulldownMenu(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmCCrreeaatteePPuullllddoowwnnM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PuullllddoowwnnM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PuullllddoowwnnMMeennuu creates an instance of a	RowColumn widget of type
  XXmmMMEENNUU__PPUULLLLDDOOWWNN and returns the associated widget ID.	 When using this
  function to create the Pulldown MenuPane, a MenuShell	widget is automati-
  cally	created	as the parent of the MenuPane. If the widget specified by the
  _p_a_r_e_n_t parameter is a	Popup or a Pulldown MenuPane, the MenuShell widget is
  created as a child of	the _p_a_r_e_n_t's MenuShell;	otherwise, it is created as a
  child	of the specified _p_a_r_e_n_t	widget.

  XXmmCCrreeaatteePPuullllddoowwnnMMeennuu is provided as a	convenience function for creating
  RowColumn widgets configured to operate as Pulldown MenuPanes	and is not
  implemented as a separate widget class.

  A Pulldown MenuPane displays a 3-D shadow, unless the	feature	is disabled
  by the application.  The shadow appears around the edge of the MenuPane.

  A Pulldown MenuPane is used when creating submenus that are to be attached
  to a CascadeButton or	a CascadeButtonGadget.	This is	the case for all
  MenuPanes that are part of a PulldownMenu system (a MenuBar),	the MenuPane
  associated with an OptionMenu, and any MenuPanes that	cascade	from a Popup
  MenuPane.  Pulldown MenuPanes	that are to be associated with an OptionMenu
  must be created before the OptionMenu	is created.

  The Pulldown MenuPane	must be	attached to a CascadeButton or CascadeBut-
  tonGadget that resides in a MenuBar, a Popup MenuPane, a Pulldown MenuPane,
  or an	OptionMenu.  This is done by using the button resource XXmmNNssuubbMMeennuuIIdd.

  A MenuShell widget is	required between the Pulldown MenuPane and its
  parent.  If the application uses this	convenience function for creating a
  Pulldown MenuPane, the MenuShell is automatically created as the real
  parent of the	MenuPane; otherwise, it	is the application's responsibility
  to create the	MenuShell widget.

  To function correctly	when incorporated into a menu, the Pulldown
  MenuPane's hierarchy must be considered; this	hierarchy depends on the type
  of menu system that is being built as	follows:

    oo++  If the Pulldown MenuPane	is to be pulled	down from a MenuBar, its
       _p_a_r_e_n_t must be the MenuBar.

    oo++  If the Pulldown MenuPane	is to be pulled	down from a Popup or another
       Pulldown	MenuPane, its _p_a_r_e_n_t must be that Popup	or Pulldown MenuPane.

    oo++  If the Pulldown MenuPane	is to be pulled	down from an OptionMenu, its
       _p_a_r_e_n_t must be the same as the OptionMenu parent.

    oo++  Specifies the parent widget ID

    oo++  Specifies the name of the created widget

    oo++  Specifies the argument list

    oo++  Specifies the number of attribute/value pairs in	the argument list
       (_a_r_g_l_i_s_t)

  PullDown 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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eOOppttiioonnMMeennuu((33XX)),
  XXmmCCrreeaatteePPooppuuppMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((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PuullllddoowwnnMMeennuu((33XX)).













































