XmListReplaceItemsUnselected(3X)
Prev | Reference Pages | Next

## Name

XmListReplaceItemsUnselected(3X) — XmListReplaceItemsUnselected--A List function that replaces items in a list XmListReplaceItemsUnselectedList functions

## Synopsis

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

## DESCRIPTION

XmListReplaceItemsUnselected replaces each specified item in the list with a corresponding new item. The replacement items remain unselected, even if they currently appear in the XmNselectedItems list.

`widget` |  | Specifies the ID of the List widget to replace items in.
`old_items` |  | Specifies a pointer to the list items to be replaced.
`item_count` |  | Specifies the number of elements in `old_items` and `new_items`. This number must be non-negative.
`new_items` |  | Specifies a pointer to the replacement items. Every occurrence of each element of `old_items` is replaced with the corresponding element from `new_items`. That is, the first element of `old_items` is replaced with the first element of `new_items`. The second element of `old_items` is replaced with the second element of `new_items`, and so on until `item_count` is reached. If an element in `old_items` does not exist in the list, the corresponding entry in `new_items` is skipped.

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

## RELATED INFORMATION

XmList(3X).

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