Man Linux: Main Page and Category List

NAME

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

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(library call)