<!-- $XConsortium: CreMeA.sgm /main/8 1996/09/08 20:33:32 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMMA.MAN149.rsml.1">
<RefMeta>
<RefEntryTitle>XmCreateMenuBar</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmCreateMenuBar</Function></RefName>
<RefPurpose>A RowColumn widget convenience creation function
<IndexTerm>
<Primary>XmCreateMenuBar</Primary>
</IndexTerm><IndexTerm>
<Primary>creation functions</Primary>
<Secondary>XmCreateMenuBar</Secondary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!-- -->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!-- -->
<!-- HISTORY-->
<!-- -->
<!-- **-->
<!-- **-->
<!-- **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.-->
<!-- **      All Rights Reserved.-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,-->
<!-- **      Maynard, MA.  All Rights Reserved.-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/RowColumn.h>
</FuncSynopsisInfo>
<FuncDef>Widget <Function>XmCreateMenuBar</Function></FuncDef>
<!--<ParamDef><Replaceable>parent, name, arglist, argcount</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>parent</Parameter></ParamDef>
<ParamDef>String <Parameter>name</Parameter></ParamDef>
<ParamDef>ArgList <Parameter>arglist</Parameter></ParamDef>
<ParamDef>Cardinal <Parameter>argcount</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmCreateMenuBar</Function> creates an instance of a RowColumn widget
of type <SystemItem Class="Constant">XmMENU_BAR</SystemItem> 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.
</Para>
<Para>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.
</Para>
<Para>The MenuBar displays a 3-D shadow along its border. The application
controls the shadow attributes using the visual-related resources
supported by <Classname>XmManager</Classname>.
</Para>
<Para>The MenuBar widget is homogeneous in that it accepts only children
that are a subclass of <Classname>XmCascadeButton</Classname> or
<Classname>XmCascadeButtonGadget</Classname>.
Attempting to insert a child of a different class results in a warning
message.
</Para>
<Para>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.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">parent</Symbol></Term>
<ListItem>
<Para>Specifies the parent widget ID
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">name</Symbol></Term>
<ListItem>
<Para>Specifies the name of the created widget
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">arglist</Symbol></Term>
<ListItem>
<Para>Specifies the argument list
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">argcount</Symbol></Term>
<ListItem>
<Para>Specifies the number of attribute/value pairs in the argument list
(<Symbol Role="Variable">arglist</Symbol>)
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>For a complete definition of RowColumn and its associated resources, see
&cdeman.XmRowColumn;.
</Para>
</RefSect1>
<RefSect1>
<Title>RETURN</Title>
<Para>Returns the RowColumn widget ID.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmCascadeButton;,
&cdeman.XmCascadeButtonGadget;,
&cdeman.XmCreatePulldownMenu;,
&cdeman.XmCreateSimpleMenuBar;,
&cdeman.XmManager;,
&cdeman.XmRowColumn;, and
&cdeman.XmVaCreateSimpleMenuBar;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
