LVM_SETITEMTEXT

This message changes the text of a list view item or subitem. You can send this message explicitly or by using the ListView_SetItemText macro.

At a Glance

Header file: Commctrl.h
Windows CE versions: 1.0 and later
Related macro: ListView_SetItemText

Syntax

LVM_SETITEMTEXT wParam = (WPARAM)(int) i;
lParam = (LPARAM)(LV_ITEM FAR *) pitem;

Parameters

i

Index of the list view item

pitem

Pointer to an LVITEM structure. The iSubItem member is the index of the subitem, or it can be zero to set the item label. The pszText member is the address of a null-terminated string containing the new text; it can also be NULL.

The pszText member can also be LPSTR_TEXTCALLBACK to indicate a callback item for which the parent window stores the text. In this case, the list view control sends the parent an LVN_GETDISPINFO notification message when it needs the text.

Return Values

If you send this message explicitly, TRUE indicates success. FALSE indicates failure.