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;
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTION
XmCreateMenuBar creates an instance of a RowColumn widget of
type XmMENUBAR 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
Page 1 (printed 4/30/98)
XmCreateMenuBar(3X) UNIX System V XmCreateMenuBar(3X)
arglistSpecifies 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(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 (printed 4/30/98)