ListView_GetItemText

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

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 Values

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

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

See Also

LVITEM | LVM_GETITEMTEXT | List-View Controls Macros

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.