PtListAddItems()

Add items to a list

Synopsis:

int PtListAddItems( PtWidget_t *widget,
                    const char **items,
                    int item_count,
                    unsigned int position );

Description:

This function lets you add one or more items to a list widget at a specified position. The items argument points to an array of items and item_count indicates the number of strings in the array.

List positions start at 1, not 0. If you specify a position of 0, the items are added to the end of the list.

If you add new items in between existing items, the rest of the items are moved down the list.

Returns:

0
Success.
-1
A memory allocation error occurred, or the specified widget isn't a PtList widget.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtList