TreeView_SetCheckState Makro (commctrl.h)

Legt das Statusbild des Elements auf "aktiviert" oder "deaktiviert" fest. Sie können die TVM_SETITEM-Nachricht auch direkt verwenden.

Syntax

void TreeView_SetCheckState(
   hwndTV,
   hti,
   fCheck
);

Parameter

hwndTV

Typ: HWND

Handle für das Strukturansichtssteuerelement.

hti

Typ: HTREEITEM

Handle für das Element.

fCheck

Typ: BOOL

Wert, der angibt, welches Zustandsbild angezeigt wird. Legen Sie fCheck auf TRUE fest, um das aktivierte Zustandsbild anzuzeigen, oder auf FALSE , um das nicht markierte Bild anzuzeigen.

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 Statusbildliste gespeichert und links neben dem entsprechenden Normalbild angezeigt. Zustandsbilder werden durch einen 1-basierten Index angegeben. Ein Index von 0 (null) gibt an, dass kein Zustandsbild vorhanden ist. Unter Tree-View Image 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 nicht aktivierten Bilder die gleichen 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