XmCreateMenuBar(3X)

     NAME
          XmCreateMenuBar - A RowColumn widget convenience creation
          function

     SYNOPSIS
          #include <Xm/RowColumn.h>

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

     DESCRIPTION
          XmCreateMenuBar creates an instance of a RowColumn widget of
          type XmMENU_BAR and returns the associated widget ID.It is
          provided as a convenience 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 Pulldown 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 controls the shadow attributes using the
          visual-related resources supported by XmManager.

          The MenuBar widget is  homogeneous in that it accepts only
          children that are a subclass of XmCascadeButton or
          XmCascadeButtonGadget.  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 additional lines if allowed by
          the geometry manager of the parent widget.

          parent
               Specifies the parent widget ID

          name Specifies the name of the created widget

          arglist
               Specifies the argument list

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

          For a complete definition of RowColumn and its associated
          resources, see XmRowColumn(3X).

     RETURN VALUE
          Returns the RowColumn widget ID.

     RELATED INFORMATION
          XmCascadeButton(3X), XmCascadeButtonGadget(3X),
          XmCreatePulldownMenu(3X), XmCreateSimpleMenuBar(3X),
          XmManager(3X), XmRowColumn(3X), and
          XmVaCreateSimpleMenuBar(3X).