CListCtrl::SetItemData

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

BOOL SetItemData(
   int nItem,
   DWORD_PTR dwData 
);

Parameters

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

  • dwData
    A 32-bit value to be associated with the item.

Return Value

Nonzero if successful; otherwise 0.

Remarks

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

Example

// Set the data of each item to be equal to its index.
for (int i = 0; i < m_myListCtrl.GetItemCount(); i++)
{
   m_myListCtrl.SetItemData(i, i);
}

Requirements

Header: afxcmn.h

See Also

Reference

CListCtrl Class

Hierarchy Chart

CListCtrl::GetItemData

Other Resources

CListCtrl Members