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)