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)