TreeView_GetCheckState Makro (commctrl.h)

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

Syntax

void TreeView_GetCheckState(
   hwndTV,
   hti
);

Parameter

hwndTV

Typ: HWND

Handle mit dem Strukturansichtssteuerelement.

hti

Typ: HTREEITEM

Handle mit dem Element.

Rückgabewert

Keine

Bemerkungen

Ein Strukturansichtssteuerelement kann über zwei Bildlisten verfügen. In der Normalen Bildliste werden die ausgewählten, nicht ausgewählten und überlagerten Bilder gespeichert. Kontrollkästchen werden in der Zustandsbildliste gespeichert und links neben dem entsprechenden Normalbild angezeigt. Zustandsbilder werden durch einen 1-basierten Index angegeben. Ein Index von 0 gibt an, dass kein Zustandsbild vorhanden ist. Unter Strukturansichtsbild Listen finden Sie eine Erläuterung zum Umgang mit Strukturansichtsbildern.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h