XmListReplaceItems(library call)           XmListReplaceItems(library call)




 NAME    [Toc]    [Back]
      XmListReplaceItems - A List function that replaces the specified
      elements in the list

 SYNOPSIS    [Toc]    [Back]
      #include <Xm/List.h>
      void XmListReplaceItems(
      Widget widget,
      XmString *old_items,
      int item_count,
      XmString *new_items);

 DESCRIPTION    [Toc]    [Back]
      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 nonnegative.

      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(3).

 RELATED    [Toc]    [Back]
      XmList(3).


                                    - 1 -       Formatted:  January 24, 2005