<!-- $XConsortium: CrePop.sgm /main/8 1996/09/08 20:34:20 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.MAN156.rsml.1">
<RefMeta>
<RefEntryTitle>XmCreatePopupMenu</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmCreatePopupMenu</Function></RefName>
<RefPurpose>A RowColumn widget convenience creation function
<IndexTerm>
<Primary>XmCreatePopupMenu</Primary>
</IndexTerm><IndexTerm>
<Primary>creation functions</Primary>
<Secondary>XmCreatePopupMenu</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>XmCreatePopupMenu</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>XmCreatePopupMenu</Function> creates an instance of a RowColumn widget
of type <SystemItem Class="Constant">XmMENU_POPUP</SystemItem> and returns
the associated widget ID. When this function is used to create the Popup
menu pane, a MenuShell widget is automatically created as the parent of
the menu pane.
The parent of the MenuShell widget is the widget indicated by the
<Symbol Role="Variable">parent</Symbol> parameter.
</Para>
<Para><Function>XmCreatePopupMenu</Function> is
provided as a convenience function for creating RowColumn
widgets configured to operate as Popup menu panes and is not implemented as
a separate widget class.
</Para>
<Para>The PopupMenu is used as the first menu pane within a PopupMenu system;
all other
menu panes are of the Pulldown type. A Popup menu pane displays a
3-D shadow, unless the feature is disabled by the application.
The shadow appears around the edge of the menu pane.
</Para>
<Para>The Popup menu pane must be created as the child of a MenuShell widget in
order to function properly when it is incorporated into a menu.
If the application uses this convenience function for creating a
Popup menu pane, the MenuShell is automatically created as the real
parent of the menu pane.
If the application does not use this convenience function to create the
RowColumn to function as a Popup menu pane,
it is the application's responsibility to create the
MenuShell widget.
</Para>
<Para>To access the PopupMenu, the application must first position the
widget using the
<Function>XmMenuPosition</Function> function and then manage it using <Function>XtManageChild</Function>.
</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>Popup menu panes support tear-off capabilities
for tear-off menus through <Classname>XmRowColumn</Classname>
resources.
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.XmCreateSimplePopupMenu;,
&cdeman.XmMenuPosition;,
&cdeman.XmMenuShell;,
&cdeman.XmRowColumn;, and
&cdeman.XmVaCreateSimplePopupMenu;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
