Share via


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.

LVM_SETITEMTEXT wParam = (WPARAM)(int) i; 
  lParam = (LPARAM)(LVITEM 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 message when it needs the text.

Return Values

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

Remarks

Related macro: ListView_SetItemText

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Commctrl.h.

See Also

ListView_SetItemText | List-View Controls Messages

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.