XmListReplaceItemsPos(3X)
Prev | Reference Pages | Next

## Name

XmListReplaceItemsPos(3X) — XmListReplaceItemsPos--A List function that replaces the specified elements in the list XmListReplaceItemsPosList functions

## Synopsis

#include <Xm/List.h>
void XmListReplaceItemsPos (`widget, new_items, item_count, position`)
Widget `widget`;
XmString `*new_items`;
int `item_count`;
int `position`;

## DESCRIPTION

XmListReplaceItemsPos 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 XmNselectedItems list. If any of the new items matches an item on the selected list, it appears selected.

`widget` |  | Specifies the ID of the List widget.
`new_items` |  | Specifies the replacement items.
`item_count` |  | Specifies the number of items in `new_items` and the number of items in the list to replace. This number must be non-negative.
`position` |  | 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. Beginning with the item specified in `position`, `item_count` items in the list are replaced with the corresponding elements from `new_items`. That is, the item at `position` is replaced with the first element of `new_items`; the item after `position` is replaced with the second element of `new_items`; and so on, until `item_count` is reached.

For a complete definition of List and its associated resources, see XmList(3X).

## RELATED INFORMATION

XmList(3X).

Prev | Table of Contents | Next
XmListReplaceItems(3X) |  | XmListReplaceItemsPosUnselected(3X)