Museum

 XmCreateMenuBar(Xm)            6 January 1993            XmCreateMenuBar(Xm)


 Name

    XmCreateMenuBar - a RowColumn widget convenience creation function

 Syntax


    #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
    XmMENUBAR and returns the associated widget ID. It is provided as a con-
    venience 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 applica-
    tion 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 Menu-
    Bar.  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 con-
    trols 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(Xm).

 Return value

    Returns the RowColumn widget ID.

 See also

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