<!-- $XConsortium: AddToPos.sgm /main/9 1996/09/08 20:24:39 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.MAN38.rsml.1">
<RefMeta>
<RefEntryTitle>XmAddToPostFromList</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmAddToPostFromList</Function></RefName>
<RefPurpose>a RowColumn function that makes a menu
accessible from more than one widget
<IndexTerm>
<Primary>XmAddToPostFromList</Primary>
</IndexTerm><IndexTerm>
<Primary>RowColumn functions</Primary>
<Secondary>XmAddToPostFromList</Secondary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!-- 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 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 Remap="not-ANSI">
<FuncSynopsisInfo>#include &lt;Xm/RowColumn.h>
<?sml-space \n(PDu></FuncSynopsisInfo>
<FuncDef>void <Function>XmAddToPostFromList</Function></FuncDef>
<!--<ParamDef><Replaceable>menu, post_from_widget</ParamDef>-->
<ParamDef>Widget <Parameter>menu</Parameter></ParamDef>
<ParamDef>Widget <Parameter>post_from_widget</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmAddToPostFromList</Function> makes a menu accessible from more than one
widget. After a menu is once created, this function may be used to
make that menu accessible from a second widget. The process may be
repeated indefinitely. In other words, where an application would use
<Function>XmCreatePopupMenu</Function> or <Function>XmCreatePulldownMenu</Function> or their
equivalent to create a new menu identical to one that already exists,
it can use this function to reuse that earlier menu.
</Para>
<Para>If <Symbol Role="Variable">menu</Symbol> refers to a Popup menu, then the <Symbol Role="Variable">post_from_widget</Symbol>
widget can now pop up the specified menu. The actual posting of the
menu occurs as it always does, either through an event handler, or the
automatic popup menu support (see the &cdeman.XmRowColumn; reference
page).
</Para>
<Para>If <Symbol Role="Variable">menu</Symbol> refers to a Pulldown menu, its ID is placed in the
<SystemItem Class="Resource">XmNsubMenuId</SystemItem> resource of the specified <Symbol Role="Variable">post_from_widget</Symbol>.
In this case, the <Symbol Role="Variable">post_from_widget</Symbol> widget must be either a
CascadeButton or a CascadeButtonGadget.
</Para>
<Para>Note that this function manipulates the internal structures
themselves, not a copy of them.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">menu</Symbol></Term>
<ListItem>
<Para>Specifies the ID of the RowColumn widget containing the menu (Popup or
Pulldown) to be made accessible from the widget.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">post_from_widget</Symbol></Term>
<ListItem>
<Para>Specifies the widget ID of the widget which will now be able to post
the menu specified by <Symbol Role="Variable">menu</Symbol>.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>For a complete definition of RowColumn and its associated resources, see
&cdeman.XmRowColumn;.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmGetPostedFromWidget;,
&cdeman.XmRemoveFromPostFromList;, and
&cdeman.XmRowColumn;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
