ListView::GetItemText

Retrieves the text of a list view item.

long GetItemText (
    short               listItem,
    char *              text,
    long                size
) const;

Parameters

listItem

1-based index of the list view item, use TopItem or BottomItem of Item type to specify the first or last item of the list view control.

text

Output parameter: pointer to a buffer to receive the text. This parameter can be NULL.

size

Size of the text buffer. If text is NULL, this parameter is ignored.

Return Value

The length of the item text (including the 0 terminator), or zero if size is less than the size of the item text.

Description

Use NULL for the text parameter to determine the necessary buffer size.