NAME

       XmListReplaceItemsPos  —  A List function that replaces the specified elements in the list
       "XmListReplaceItemsPos" "List functions" "XmListReplaceItemsPos"

SYNOPSIS

       #include <Xm/List.h>
       void XmListReplaceItemsPos(
       Widget widget,
       XmString *new_items,
       int item_count,
       int position);

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

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

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

RELATED

       XmList(3).

                                                                         XmListReplaceItemsPos(3)