CListCtrl::GetItemData

Article
12/01/2015

Retrieves the 32-bit application-specific value associated with the item specified by nItem.

Syntax

      DWORD_PTR GetItemData(
   int nItem 
) const;

Parameters

nItem
Index of the list item whose data is to be retrieved.

Return Value

A 32-bit application-specific value associated with the specified item.

Remarks

This value is the lParam member of the LVITEM structure, as described in the Windows SDK

Example

// If any item's data is equal to zero then reset it to -1.
for (int i=0; i < m_myListCtrl.GetItemCount(); i++)
{
    if (m_myListCtrl.GetItemData(i) == 0)
    {
        m_myListCtrl.SetItemData(i, (DWORD) -1);
    }
}

Requirements

Header: afxcmn.h