TreeView_SetCheckState Makro (commctrl.h)

Artikel
10/24/2024

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

Syntax

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      fCheck
);

Parameter

hwndTV

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

hti

Typ: HTREEITEM-

Behandeln sie das Element.

fCheck

Typ: BOOL-

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

Rückgabewert

Typ: UINT-

Der Rückgabewert wird nicht verwendet.

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

Freigeben über