LVM_GETITEMTEXT message

Retrieves the text of a list-view item or subitem. You can send this message explicitly or by using the ListView_GetItemText macro.

Parameters

wParam

Index of the list-view item.

lParam

Pointer to an LVITEM structure. To retrieve the item text, set iSubItem to zero. To retrieve the text of a subitem, set iSubItem to the subitem's index. The pszText member points to a buffer that receives the text. The cchTextMax member specifies the number of characters in the buffer.

Return value

If you send this message explicitly, it returns the number of characters in the pszText member of the LVITEM structure.

Remarks

You can also send this message by calling the ListView_GetItemText macro. However, this macro does not return the string length.

LVM_GETITEMTEXT is not supported under the LVS_OWNERDATA style.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h
Unicode and ANSI names
LVM_GETITEMTEXTW (Unicode) and LVM_GETITEMTEXTA (ANSI)