XmListReplaceItemsPos — A List function that replaces the
specified elements in the list
#include <Xm/List.h>
void XmListReplaceItemsPos(
Widget widget,
XmString *new_items,
int item_count,
int position);
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 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).