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