TreeView_GetCheckState Makro (commctrl.h)

Ruft den Überprüfungsstatus des angegebenen Elements ab. Sie können auch die TVM_GETITEMSTATE Nachricht direkt verwenden.

Syntax

UINT TreeView_GetCheckState(
   HWND      hwndTV,
   HTREEITEM hti
);

Parameter

hwndTV

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

hti

Typ: HTREEITEM-

Behandeln sie das Element.

Rückgabewert

Typ: UINT-

Ertrag:

Rückgabecode	Beschreibung
Geprüft	1
Unkontrolliert	0
Kein Kontrollkästchenbild	-1

Bemerkungen

Ein Strukturansichtssteuerelement kann über zwei Bildlisten verfügen. In der Normalbildliste werden die ausgewählten, nicht ausgewählten und überlagerten Bilder gespeichert. Kontrollkästchen werden in der Statusbildliste gespeichert und links neben dem entsprechenden Normalbild angezeigt. Zustandsbilder werden durch einen 1-basierten Index angegeben. Ein Index von Null gibt an, dass kein Zustandsbild vorhanden ist. Eine Erläuterung zur Behandlung von Strukturansichtsbildern finden Sie unter Tree-View Bildlisten.

Wenn Sie eigene Zustandsbilder definieren möchten, geht dieses Makro davon aus, dass die aktivierten und deaktivierten Bilder dieselben Indizes wie die Standardbildliste aufweisen: 1 für deaktivierte und 2 für aktiviert.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h