XmCreateMenuBar(3X) UNIX System V XmCreateMenuBar(3X)
NAME
XmCreateMenuBar - a RowColumn widget convenience creation function.
SYNOPSIS
#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
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 MenuPane associated
with it. These Pulldown MenuPanes 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)
10/89 Page 1
XmCreateMenuBar(3X) UNIX System V XmCreateMenuBar(3X)
For a complete definition of RowColumn and its associated resources, see
XmRowColumn(3X).
RETURN VALUE
Returns the RowColumn widget ID.
RELATED INFORMATION
XmCascadeButton(3X), XmCascadeButtonGadget(3X), XmCreatePulldownMenu(3X),
XmCreateSimpleMenuBar(3X), XmManager(3X), XmRowColumn(3X), and
XmVaCreateSimpleMenuBar(3X).
Page 2 10/89