XmListAddItems(3X)
Prev | Reference Pages | Next

## Name

XmListAddItems(3X) — XmListAddItems--A List function that adds items to the list XmListAddItemsList functions

## Synopsis

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

## DESCRIPTION

XmListAddItems adds the specified items to the list at the given position. The first `item_count` items of the `items` array are added to 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 to which an item is added.
`items` |  | Specifies a pointer to the items to be added to the list.
`item_count` |  | Specifies the number of items in `items`. This number must be non-negative.
`position` |  | Specifies the position of the first new item in the list. A value of 1 makes the first new item the first item in the list; a value of 2 makes it the second item; and so on. A value of 0 makes the first new item follow the last item in the list.

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

## RELATED INFORMATION

XmList(3X).

Prev | Table of Contents | Next
XmListAddItemUnselected(3X) |  | XmListAddItemsUnselected(3X)