CListCtrl::GetItemText

Retrieves the text of a list view item or subitem.

int GetItemText(
   int nItem,
   int nSubItem,
   LPTSTR lpszText,
   int nLen 
) const;
CString GetItemText(
   int nItem,
   int nSubItem 
) const;

Parameters

  • nItem
    The index of the item whose text is to be retrieved.

  • nSubItem
    Specifies the subitem whose text is to be retrieved.

  • lpszText
    Pointer to a string that is to receive the item text.

  • nLen
    Length of the buffer pointed to by lpszText.

Return Value

The version returning int returns the length of the retrieved string.

The version returning a CString returns the item text.

Remarks

If nSubItem is zero, this function retrieves the item label; if nSubItem is nonzero, it retrieves the text of the subitem. For more information on the subitem argument, see the discussion of the LVITEM structure in the Windows SDK.

Requirements

Header: afxcmn.h

See Also

Reference

CListCtrl Class

Hierarchy Chart

CListCtrl::GetItem

Other Resources

CListCtrl Members