XmListReplaceItemsPosUnselected(3X)

NAME
     XmListReplaceItemsPosUnselected  --A List function that replaces items in a
     list without selecting the replacement items

SYNOPSIS
     #include <Xm/List.h>

     void XmListReplaceItemsPosUnselected (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
     XmListReplaceItemsPosUnselected replaces the specified number of  items  in
     the  list  with new items, starting at the given position.  The replacement
     items remain unselected, even if they currently appear in  the  XmNselecte-
     dItems list.


     widget    Specifies the ID of the List widget to replace items in.

     new_items Specifies a pointer to the replacement items.

     item_countSpecifies  the  number of elements 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  re-
               placed.   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).

                                             XmListReplaceItemsPosUnselected(3X)