<!-- $XConsortium: OptionBu.sgm /main/8 1996/09/08 20:54:56 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.MAN333.rsml.1">
<RefMeta>
<RefEntryTitle>XmOptionButtonGadget</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmOptionButtonGadget</Function></RefName>
<RefPurpose>A RowColumn function that obtains the widget ID for the CascadeButtonGadget in an OptionMenu
<IndexTerm>
<Primary>XmOptionButtonGadget</Primary>
</IndexTerm><IndexTerm>
<Primary>RowColumn functions</Primary>
<Secondary>XmOptionButtonGadget</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>XmOptionButtonGadget</Function></FuncDef>
<!--<ParamDef><Replaceable>option_menu</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>option_menu</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmOptionButtonGadget</Function> provides the application with the means for
obtaining the widget ID for the internally created CascadeButtonGadget. Once
the application has obtained the widget ID, it can
adjust the visuals for the CascadeButtonGadget, if desired.
</Para>
<Para>When an application creates an instance of the OptionMenu widget, the
widget creates two internal gadgets. One is a LabelGadget that is
used to display RowColumn's <SystemItem Class="Resource">XmNlabelString</SystemItem> resource.
The other is a CascadeButtonGadget that displays the current selection
and provides the means for posting the OptionMenu's submenu.
</Para>
<Para>The user can specify resources in a resource file for the automatically
created widgets and gadgets of an OptionMenu. The following list
identifies the names of these widgets (or gadgets) and the associated
OptionMenu areas.
</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>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">option_menu</Symbol></Term>
<ListItem>
<Para>Specifies the OptionMenu widget ID
</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 widget ID for the internal button.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmCreateOptionMenu;, &cdeman.XmCascadeButtonGadget;,
&cdeman.XmOptionLabelGadget;,
and &cdeman.XmRowColumn;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
