[Contents] [Index] [Next] [Previous]

XmListReplaceItemsUnselected


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)
      Widget    widget;
      XmString  *old_items;
      int       item_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.

widget
Specifies the ID of the List widget to replace items in.
old_items
Specifies a pointer to the list items to be replaced.
item_count
Specifies the number of elements in old_items and new_items. This number must be non-negative.
new_items
Specifies 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).