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 |