DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmListReplaceItems(Xm)


XmListReplaceItems -- a List function that replaces the specified elements in the list

Syntax

#include <Xm/List.h>

void XmListReplaceItems (widget, old_items, item_count, new_items) Widget widget; XmString *old_items; int item_count; XmString *new_items;

Description

XmListReplaceItems replaces each specified item of the list with a corresponding new item. 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.

old_items
Specifies the items to be replaced.

item_count
Specifies the number of items in old_items and new_items. This number must be non-negative.

new_items
Specifies the replacement items.

Every occurrence of each element of old_items is replaced with the corresponding element from new_items. That is, the first element of old_items is replaced with the first element of new_items. The second element of old_items 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