ListView_SetItemText

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

See Also

Reference

LVM_SETITEMTEXT
List-View Controls Macros

Concepts

Control Styles