XmListReplaceItemsPos(3X)

NAME
     XmListReplaceItemsPos  -- A  List function that replaces the specified ele-
     ments in the list

SYNOPSIS
     #include <Xm/List.h>

     void XmListReplaceItemsPos (widget, new_items, item_count, position)
          Widget    widget;
          XmString  *new_items;
          int       item_count;
          int       position;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmListReplaceItemsPos replaces the specified number of items  of  the  List
     with  new  items, starting at the specified position in the List.  When the
     items are inserted into the list, they are compared with the current XmNse-
     lectedItems 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.

     new_items
            Specifies the replacement items.

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

     position
            Specifies the position of the first item in the list to be replaced.
            A value of 1 indicates that the first item  replaced  is  the  first
            item in the list; a value of 2 indicates that it is the second item;
            and so on.

            Beginning  with  the item specified in position, item_count items in
            the  list  are  replaced  with  the  corresponding   elements   from
            new_items.  That is, the item at position is replaced with the first
            element  of  new_items; the item after position 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  Xm-
     List(3X).

RELATED INFORMATION
     XmList(3X).

                                                       XmListReplaceItemsPos(3X)