OSF/Motif

NAME

XmListReplaceItemsUnselected − A List function that replaces items in a list

SYNOPSIS

#include <Xm/List.h>
void XmListReplaceItemsUnselected (widget, old_items, item_count,
new_items)
Widgetwidget;
XmString∗old_items;
intitem_count;
XmString∗new_items;

DESCRIPTION

XmListReplaceItemsUnselected replaces each specified item in the list with a corresponding new item.  The replacement items remain unselected, even if they currently appear in the XmNselectedItems list. 

widgetSpecifies the ID of the List widget to replace items in. 

old_itemsSpecifies a pointer to the list items to be replaced. 

item_countSpecifies the number of elements in old_items and new_items.  This number must be non-negative. 

new_itemsSpecifies a pointer to 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.  If an element in old_items does not exist in the list, the corresponding entry in new_items is skipped. 

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

RELATED INFORMATION

XmList(3X).