Share via


ListView_SetItemText

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

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 notification message when it needs the text.

    This parameter can be NULL.

Return Values

None.

Remarks

Related message: LVM_SETITEMTEXT

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.