ListView_GetItemText

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

void WINAPI ListView_GetItemText( 
  HWND hwnd, 
  int iItem, 
  int iSubItem,
  LPSTR pszText, 
  int cchTextMax 
);

Parameters

  • hwnd
    Handle to the list-view control.
  • iItem
    Index of the list-view item.
  • iSubItem
    Index of the subitem, or zero to retrieve the item label.
  • pszText
    Pointer to the buffer that receives the item or subitem text.
  • cchTextMax
    Size of the buffer, in bytes.

Return Value

The ListView_GetItemText macro does not return a value. If you send the LVM_GETITEMNEXT message explicitly, it returns the length of the retrieved string.

Remarks

Related message: LVM_GETITEMTEXT

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

LVITEM
LVM_GETITEMTEXT
List-View Controls Macros