OSF/Motif

NAME

XmCreateMenuBar − A RowColumn widget convenience creation function

SYNOPSIS

#include <Xm/RowColumn.h>
Widget XmCreateMenuBar (parent, name, arglist, argcount)
Widgetparent;
Stringname;
ArgListarglist;
Cardinalargcount;

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. 

parentSpecifies the parent widget ID

nameSpecifies the name of the created widget

arglistSpecifies the argument list

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