<!-- $XConsortium: LstReplB.sgm /main/8 1996/09/08 20:51:24 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.MAN304.rsml.1">
<RefMeta>
<RefEntryTitle>XmListReplaceItemsPos</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmListReplaceItemsPos</Function></RefName>
<RefPurpose>A List function that replaces the specified elements in the list
<IndexTerm>
<Primary>XmListReplaceItemsPos</Primary>
</IndexTerm><IndexTerm>
<Primary>List functions</Primary>
<Secondary>XmListReplaceItemsPos</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-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/List.h>
</FuncSynopsisInfo>
<FuncDef>void <Function>XmListReplaceItemsPos</Function></FuncDef>
<!--<ParamDef><Replaceable>widget, new_items, item_count, position</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>widget</Parameter></ParamDef>
<ParamDef>XmString *<Parameter>new_items</Parameter></ParamDef>
<ParamDef>int <Parameter>item_count</Parameter></ParamDef>
<ParamDef>int <Parameter>position</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmListReplaceItemsPos</Function> replaces the specified number of
items of the List with new items, starting at the specified position
in the List.
When the items are inserted into the list, they are compared with
the current <SystemItem Class="Resource">XmNselectedItems</SystemItem> list. If any of the new items
matches an item on the selected list, it appears selected.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">widget</Symbol></Term>
<ListItem>
<Para>Specifies the ID of the List widget.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">new_items</Symbol></Term>
<ListItem>
<Para>Specifies the replacement items.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">item_count</Symbol></Term>
<ListItem>
<Para>Specifies the number of items in <Symbol Role="Variable">new_items</Symbol> and the number of
items in the list to replace.
This number must be nonnegative.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">position</Symbol></Term>
<ListItem>
<Para>Specifies the position of the first item in the list to be replaced.
A value of 1 indicates that the first item replaced is the first item in
the list; a value of 2 indicates that it is the second item; and so on.
<!-- A value of 0 indicates that the first item replaced is the last item in--><!-- the list.--></Para>
<Para>Beginning with the item specified in <Symbol Role="Variable">position</Symbol>, <Symbol Role="Variable">item_count</Symbol>
items in the list are replaced with the corresponding elements from
<Symbol Role="Variable">new_items</Symbol>.
That is, the item at <Symbol Role="Variable">position</Symbol> is replaced with the first element
of <Symbol Role="Variable">new_items</Symbol>; the item after <Symbol Role="Variable">position</Symbol> is replaced with the
second element of <Symbol Role="Variable">new_items</Symbol>; and so on, until <Symbol Role="Variable">item_count</Symbol> is
reached.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>For a complete definition of List and its associated resources, see
&cdeman.XmList;.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmList;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
