CListCtrl::SetItemState
Ändert den Zustand eines Elements in einem ListView-Steuerelement.
BOOL SetItemState(
int nItem,
LVITEM* pItem
);
BOOL SetItemState(
int nItem,
UINT nState,
UINT nMask
);
Parameter
nItem
Index des Elements, dessen Zustand festgelegt werden soll.pItem
Adresse einer LVITEM-Struktur, wie in Windows SDK beschrieben. Der stateMask-Member der Struktur gibt an, die Bits angeben, um zu ändern, und der state-Member der Struktur enthält die neue Werte für diese Bits. Die anderen Member werden ignoriert.nState
Neue Werte für die Zustandsbits. Eine Liste der möglichen Werten, finden Sie unter CListCtrl::GetNextItem und den LVITEM Zustandsmember.nMask
Maskieren Sie das Angeben, die Bits angeben, um sich zu ändern. Dieser Wert entspricht dem stateMask Member der LVITEM-Struktur.
Rückgabewert
Ungleich 0 (null), wenn erfolgreich; null andernfalls.
Hinweise
"Der Zustand" eines Elements ist ein Wert, der die Verfügbarkeit des Elements angibt, gibt Benutzeraktionen oder gibt andernfalls den Status des Elements. Änderungen eines Listenansicht-Steuerelements einige geben Bits, wie an, wenn der Benutzer ein Element auswählt. Eine Anwendung könnte andere Zustandsbits, um das Element zu deaktivieren oder auszublenden, oder ein Overlaybild anzugeben oder Bild anzugeben.
Beispiel
Im Beispiel für CListCtrl::GetTopIndex.
Anforderungen
Header: afxcmn.h