ListView_SetItemText

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This macro changes the text of a list-view item or subitem. You can use this macro or send the LVM_SETITEMTEXT message explicitly.

Syntax

void WINAPI ListView_SetItemText( 
  HWND hwnd, 
  int i, 
  int iSubItem, 
  LPCSTR pszText 
);

Parameters

  • hwnd
    Handle to the list-view control.
  • i
    Index of the list-view item.
  • iSubItem
    Index of the subitem. To set the item label, set iSubItem to zero.

  • pszText
    Pointer to a null-terminated string that contains the new text.

    This parameter can 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.

    This parameter can be NULL.

Return Value

None.

Remarks

Calls to ListView_SetItemText will fail if the control was created with the LVS_OWNERDATA control styles.

Related message: LVM_SETITEMTEXT

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

LVM_SETITEMTEXT
List-View Controls Macros

Concepts

Control Styles