DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmListReplacePositions(Xm)


XmListReplacePositions -- a List function that replaces items in a list based on position

Syntax

#include <Xm/List.h>

void XmListReplacePositions (widget, position_list, item_list, item_count) Widget widget; int *position_list; XmString *item_list; int item_count;

Description

XmListReplacePositions replaces noncontiguous items in a list. The item at each position specified in position_list is replaced with the corresponding entry in item_list. When the items are inserted into the list, they are compared with the current XmNselectedItems list. Any of the new items that match items on the selected list appears selected. A warning message is displayed if a specified position is invalid; that is, the value is 0, a negative integer, or a number greater than the number of items in the list.

widget
Specifies the ID of the List widget.

position_list
Specifies an array of the positions of items to be replaced. The position of the first item in the list is 1; the position of the second item is 2; and so on.

item_list
Specifies an array of the replacement items.

item_count
Specifies the number of elements in position_list and item_list. This number must be non-negative.

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