---
name: "XmListReplaceItemsPosUnselected"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmListReplaceItemsPosUnselected"
---

# XmListReplaceItemsPosUnselected(3)

A List function that replaces items in a list without selecting the replacement items

## NAME

**XmListReplaceItemsPosUnselected** — A List function that replaces items in a list without selecting the replacement items

## SYNOPSIS

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

## DESCRIPTION

**XmListReplaceItemsPosUnselected** replaces the specified number of items in the list with new items, starting at the given position. 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.

- *new\_items*

  Specifies a pointer to the replacement items.

- *item\_count*

  Specifies the number of elements in *new\_items* and the number of items in the list to replace. This number must be nonnegative.

- *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**(3)](/XmList/3.md).

## RELATED

[**XmList**(3)](/XmList/3.md).