XmCreateMenuBar






XmCreateMenuBar — A RowColumn widget convenience creation
function



     #include <Xm/RowColumn.h>
Widget XmCreateMenuBar(
Widget parent,
String name,
ArgList arglist,
Cardinal argcount);



     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).









                             ‐2‐




     Returns the RowColumn widget ID.



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