Museum

 XmListReplaceItemsUnselected(Xm)            XmListReplaceItemsUnselected(Xm)
                                6 January 1993


 Name

    XmListReplaceItemsUnselected - a List function that replaces items in a
    list

 Syntax


    #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.

    olditems
            Specifies a pointer to the list items to be replaced.

    itemcount
            Specifies the number of elements in olditems and newitems.
            This number must be non-negative.

    newitems
            Specifies a pointer to the replacement items.  Every occurrence
            of each element of olditems is replaced with the corresponding
            element from newitems.  That is, the first element of olditems
            is replaced with the first element of newitems.  The second ele-
            ment of olditems is replaced with the second element of
            newitems, and so on until itemcount is reached.  If an element
            in olditems does not exist in the list, the corresponding entry
            in newitems is skipped.

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

 See also

    XmList(Xm)