NAME

       XmCreateMenuBar — A RowColumn widget convenience creation function "XmCreateMenuBar" "creation functions"
       "XmCreateMenuBar"

SYNOPSIS

       #include <Xm/RowColumn.h>
       Widget XmCreateMenuBar(
       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 menu pane associated with it.   These  Pulldown  menu
       panes  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(3).

RETURN

       Returns the RowColumn widget ID.

RELATED

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

                                                                                              XmCreateMenuBar(3)