XmListReplaceItemsPos(3X) — DG/UX R4.11MU05



XmListReplaceItemsPos(3X)     SDK X11 R4.11MU05    XmListReplaceItemsPos(3X)


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

SYNOPSIS
       #include <Xm/List.h>

       void XmListReplaceItemsPos (widget, newitems, itemcount, position)
            Widget    widget;
            XmString  *newitems;
            int       itemcount;
            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.

        newitems
               Specifies the replacement items.

        itemcount
               Specifies the number of items in newitems 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, itemcount items in
       the list are replaced with the corresponding elements from newitems.
       That is, the item at position is replaced with the first element of
       newitems; the item after position is replaced with the second
       element of newitems; and so on, until itemcount is reached.


       For a complete definition of List and its associated resources, see
       XmList(3X).

RELATED INFORMATION
       XmList(3X).


Licensed material--property of copyright holder(s)
Museum
