XmListReplaceItemsPos(library call)     XmListReplaceItemsPos(library call)




 NAME    [Toc]    [Back]
      XmListReplaceItemsPos - A List function that replaces the specified
      elements in the list

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

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      XmList(3).


                                    - 1 -       Formatted:  January 24, 2005