Museum

 XmListAddItems(Xm)             6 January 1993             XmListAddItems(Xm)


 Name

    XmListAddItems - a List function that adds items to the list

 Syntax


    #include <Xm/List.h>

    void XmListAddItems (widget, items, item_count, position)
    Widget widget;
    XmString *items;
    int item_count;
    int position;


 Description

    XmListAddItems adds the specified items to the list at the given posi-
    tion.  The first itemcount items of the items array are added to 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 to which an item is added.

    items   Specifies a pointer to the items to be added to the list.

    itemcount
            Specifies the number of items in items.  This number must be
            non-negative.

    position
            Specifies the position of the first new item in the list.  A
            value of 1 makes the first new item the first item in the list; a
            value of 2 makes it the second item; and so on.  A value of 0
            makes the first new item follow the last item in the list.

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

 See also

    XmList(Xm)