PlusWnd::LstView_AddItem

The PlusWnd::LstView_AddItem function adds an item in a ListViewControl.

Syntax

[number] LstView_AddItem(
    [string] ControlId
    [string] MainText
    [number,optional] ItemData
    [number,optional] Position
);

Parameters

ControlId

[string] Unique identifier of the control.

MainText

[string] Text to be inserted in the first column of the list for this item.

ItemData

[number,optional] If used, a number associated with the new item. It can be anything the developer wishes it to be.

Position

[number,optional] If used, the 0 based position of the new item. If this parameter is not specified, the new item is added at the end of the list.

Return Value

If the new item is added successfully, the return value is the index of the new item in the list. If not, the return value is -1.

This function typically fails for the following reason:

• The PlusWnd object refers to a window that has been destroyed.

Remarks

None.

Function Information

See Also

PlusWnd Object.