XmListAddItem(3Xm)

NAME
XmListAddItem — a List function that adds an item to the list.

SYNOPSIS
#include <Xm/List.h>

void XmListAddItem (widget, item, position)
    Widget    widget;
    XmString    item;
    int    position;

DESCRIPTION
XmListAddItem adds an item to the list at the given position. The position specifies the location of the new item in the list. Position 1 is the first element, position 2 is the second, and so on. If the position argument is zero, the item is added after the last item in the list. When the item is inserted into the list, it is compared against the current XmNselectedItems list. If the new item matches an item on the selected list, it appears selected.

widget
    Specifies the ID of the List from whose list an item is added.

item
    Specifies the item to be added to the list.

position
    Specifies the placement of the item within the list in terms of its cell position. It uses an insert mode/cell number scheme with a 1 specifying the top-entry position and a zero specifying the bottom entry for adding an item to the bottom of the list.

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

RELATED INFORMATION
XmList(3Xm).