Export (0) Print
Expand All
MFC
Expand Minimize
0 out of 1 rated this helpful - Rate this topic

CListCtrl::SetItemState

Changes the state of an item in a list view control.

BOOL SetItemState(
   int nItem,
   LVITEM* pItem 
);
BOOL SetItemState(
   int nItem,
   UINT nState,
   UINT nMask 
);
nItem

Index of the item whose state is to be set.

pItem

Address of an LVITEM structure, as described in the Windows SDK. The structure's stateMask member specifies which state bits to change, and the structure's state member contains the new values for those bits. The other members are ignored.

nState

New values for the state bits. For a list of possible values, see CListCtrl::GetNextItem and the LVITEM state member.

nMask

Mask specifying which state bits to change. This value corresponds to the stateMask member of the LVITEM structure.

Nonzero if successful; otherwise zero.

An item's "state" is a value that specifies the item's availability, indicates user actions, or otherwise reflects the item's status. A list view control changes some state bits, such as when the user selects an item. An application might change other state bits to disable or hide the item, or to specify an overlay image or state image.

See the example for CListCtrl::GetTopIndex.

Header: afxcmn.h

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.