XmCreateMenuBar

XmCreateMenuBar(library call)                    XmCreateMenuBar(library call)



NAME
       XmCreateMenuBar — A RowColumn widget convenience creation function

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(library call)