Index Index for
Section 3X
Index Alphabetical
listing for X
Bottom of page Bottom of
page		 

XmCreatePulldownMenu(3X)


OSF/Motif


NAME

  XmCreatePulldownMenu - A RowColumn widget convenience creation function


SYNOPSIS

  #include <Xm/RowColumn.h>

  Widget XmCreatePulldownMenu (parent, name, arglist, argcount)
	  Widget parent;
	  String name;
	  ArgList arglist;
	  Cardinal argcount;


DESCRIPTION

  XmCreatePulldownMenu creates an instance of a RowColumn widget of type
  XmMENU_PULLDOWN and returns the associated widget ID.	 When using this
  function to create the Pulldown MenuPane, a MenuShell widget is
  automatically created as the parent of the MenuPane. If the widget
  specified by the parent parameter is a Popup or a Pulldown MenuPane, the
  MenuShell widget is created as a child of the parent's MenuShell;
  otherwise, it is created as a child of the specified parent widget.

  XmCreatePulldownMenu 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
  CascadeButtonGadget that resides in a MenuBar, a Popup MenuPane, a Pulldown
  MenuPane, or an OptionMenu.  This is done by using the button resource
  XmNsubMenuId.

  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:

    ·  If the Pulldown MenuPane is to be pulled down from a MenuBar, its
       parent must be the MenuBar.

    ·  If the Pulldown MenuPane is to be pulled down from a Popup or another
       Pulldown MenuPane, its parent must be that Popup or Pulldown MenuPane.

    ·  If the Pulldown MenuPane is to be pulled down from an OptionMenu, its
       parent must be the same as the OptionMenu parent.

    ·  Specifies the parent widget ID

    ·  Specifies the name of the created widget

    ·  Specifies the argument list

    ·  Specifies the number of attribute/value pairs in the argument list
       (arglist)

  PullDown MenuPanes support tear-off capabilities for tear-off menus through
  XmRowColumn resources. For a complete definition of RowColumn and its
  associated resources, see XmRowColumn(3X).


RETURN VALUE

  Returns the RowColumn widget ID.


SEE ALSO

  XmCascadeButton(3X), XmCascadeButtonGadget(3X), XmCreateOptionMenu(3X),
  XmCreatePopupMenu(3X), XmCreateSimplePulldownMenu(3X), XmMenuShell(3X),
  XmRowColumn(3X), XmVaCreateSimplePulldownMenu(3X)

Index Index for
Section 3X
Index Alphabetical
listing for X
Top of page Top of
page