<!-- $XConsortium: CreSiC.sgm /main/7 1996/08/30 14:54:35 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.MAN176.rsml.1">
<RefMeta>
<RefEntryTitle>XmCreateSimpleOptionMenu</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmCreateSimpleOptionMenu</Function></RefName>
<RefPurpose>A RowColumn widget convenience creation function
<IndexTerm>
<Primary>XmCreateSimpleOptionMenu</Primary>
</IndexTerm><IndexTerm>
<Primary>creation functions</Primary>
<Secondary>XmCreateSimpleOptionMenu</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>XmCreateSimpleOptionMenu</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>XmCreateSimpleOptionMenu</Function> creates an instance of a RowColumn widget
of type <SystemItem Class="Constant">XmMENU_OPTION</SystemItem> and returns the associated widget ID.
</Para>
<Para>This routine creates an OptionMenu and its submenu containing
PushButtonGadget or CascadeButtonGadget children.
The name of each button is <Literal>button_</Literal><Symbol Role="Variable">n</Symbol>, where <Symbol Role="Variable">n</Symbol> is an integer
from 0 (zero) to the number of buttons in the menu minus 1.
The name of each separator is <Literal>separator_</Literal><Symbol Role="Variable">n</Symbol>, where <Symbol Role="Variable">n</Symbol> is an integer
from 0 (zero) to the number of separators in the menu minus 1.
Buttons and separators are named and created in the order they
are specified in the RowColumn simple menu creation resources supplied
in the argument list.
</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>The user can specify resources in a resource file for the automatically
created widgets and gadgets of an OptionMenu.
These widgets (or gadgets) and the associated
OptionMenu areas are
</Para>
<VariableList>
<VarListEntry>
<Term>Option Menu Label Gadget</Term>
<ListItem>
<Para><Literal>OptionLabel</Literal>
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Option Menu Cascade Button</Term>
<ListItem>
<Para><Literal>OptionButton</Literal>
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>A number of resources exist specifically for use with this and
other simple menu creation routines.
The only button types allowed in the <SystemItem Class="Resource">XmNbuttonType</SystemItem> resource are
<SystemItem Class="Constant">XmPUSHBUTTON</SystemItem>, <SystemItem Class="Constant">XmCASCADEBUTTON</SystemItem>, <SystemItem Class="Constant">XmSEPARATOR</SystemItem>, and
<SystemItem Class="Constant">XmDOUBLE_SEPARATOR</SystemItem>.
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.XmCreateOptionMenu;,
&cdeman.XmCreateRowColumn;,
&cdeman.XmRowColumn;, and
&cdeman.XmVaCreateSimpleOptionMenu;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
