Export (0) Print
Expand All
MFC
Expand Minimize

CListCtrl::SetItem 

Sets some or all of a list view item's attributes.


BOOL SetItem(
   const LVITEM* pItem 
);
BOOL SetItem(
   int nItem,
   int nSubItem,
   UINT nMask,
   LPCTSTR lpszItem,
   int nImage,
   UINT nState,
   UINT nStateMask,
   LPARAM lParam 
);
BOOL SetItem(
   int nItem,
   int nSubItem,
   UINT nMask,
   LPCTSTR lpszItem,
   int nImage,
   UINT nState,
   UINT nStateMask,
   LPARAM lParam,
   int nIndent 
);

Parameters

pItem

Address of an LVITEM structure that contains the new item attributes, as described in the Platform SDK. The structure's iItem and iSubItem members identify the item or subitem, and the structure's mask member specifies which attributes to set. For more information on the mask member, see the Remarks.

nItem

Index of the item whose attributes are to be set.

nSubItem

Index of the subitem whose attributes are to be set.

nMask

Specifies which attributes are to be set (see the Remarks).

lpszItem

Address of a null-terminated string specifying the item's label.

nImage

Index of the item's image within the image list.

nState

Specifies values for states to be changed (see the Remarks).

nStateMask

Specifies which states are to be changed (see the Remarks).

lParam

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

nIndent

Width, in pixels, of the indentation. If nIndent is less than the system-defined minimum width, the new width is set to the system-defined minimum

Nonzero if successful; otherwise zero.

The iItem and iSubItem members of the LVITEM structure and the nItem and nSubItem parameters identify the item and subitem whose attributes are to be set.

The mask member of the LVITEM structure and the nMask parameter specify which item attributes are to be set:

  • LVIF_TEXT   The pszText member or the lpszItem parameter is the address of a null-terminated string; the cchTextMax member is ignored.

  • LVIF_STATE   The stateMask member or nStateMask parameter specifies which item states to change and the state member or nState parameter contains the values for those states.

See the example for CListCtrl::HitTest.

Community Additions

ADD
Show:
© 2014 Microsoft