XmListReplaceItemsPos(Xm)
XmListReplaceItemsPos --
a List function that replaces the specified elements in the list
Syntax
#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(Xm).
See also
XmList(Xm)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003