Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Jedem Element in einem Struktursteuerelement (CTreeCtrl) kann ein Paar Bitmap-Bilder zugeordnet werden. Die Bilder werden auf der linken Seite der Beschriftung eines Elements angezeigt. Ein Bild wird angezeigt, wenn das Element ausgewählt ist, und die andere wird angezeigt, wenn das Element nicht ausgewählt ist. Ein Element kann z. B. einen geöffneten Ordner anzeigen, wenn er ausgewählt ist, und einen geschlossenen Ordner, wenn es nicht ausgewählt ist.
Zum Verwenden von Elementbildern müssen Sie eine Bildliste erstellen, indem Sie ein CImageList-Objekt erstellen und die CImageList::Create-Funktion verwenden, um die zugeordnete Bildliste zu erstellen. Fügen Sie dann der Liste die gewünschten Bitmaps hinzu, und ordnen Sie die Liste dem Struktursteuerelement mithilfe der SetImageList-Memberfunktion zu. Standardmäßig zeigen alle Elemente das erste Bild in der Bildliste sowohl für den ausgewählten als auch für den nicht ausgewählten Zustand an. Sie können das Standardverhalten für ein bestimmtes Element ändern, indem Sie die Indizes der ausgewählten und nicht ausgewählten Bilder angeben, wenn Sie das Element mithilfe der InsertItem-Memberfunktion zum Struktursteuerelement hinzufügen. Sie können die Indizes nach dem Hinzufügen eines Elements mithilfe der SetItemImage-Memberfunktion ändern.
Die Bildlisten eines Baumsteuerelements können auch Overlay-Bilderenthalten, die den Objektbildern überlagert werden können. Ein Wert ungleich Null in den Bits 8 bis 11 des Status eines Baumsteuerelementes gibt den einbasigen Index eines Überlagerungsbildes an (0 zeigt kein Überlagerungsbild an). Da ein 4-Bit-Index mit 1 als Ausgangspunkt verwendet wird, müssen Overlay-Bilder zu den ersten 15 Bildern in den Bildlisten gehören. Weitere Informationen zu Baumsteuerelementzuständen finden Sie unter Übersicht über Baumsteuerelementzustände weiter oben in diesem Thema.
Wenn eine Statusbildliste angegeben ist, reserviert ein Baumsteuerelement links vom Symbol jedes Elements Platz für ein Statusbild. Eine Anwendung kann Zustandsbilder verwenden, z. B. aktivierte und deaktivierte Kontrollkästchen, um anwendungsdefinierte Elementzustände anzugeben. Ein Wert ungleich Null in den Bits 12 bis 15 gibt den einbasigen Index eines Zustandsbildes an (0 gibt kein Zustandsbild an).
Durch Angeben des I_IMAGECALLBACK Werts anstelle des Indexes eines Bilds können Sie die Angabe des ausgewählten oder nicht ausgewählten Bilds verzögern, bis das Element neu gezeichnet werden soll. I_IMAGECALLBACK weist das Struktursteuerelement an, die Anwendung für den Index abzufragen, indem es die TVN_GETDISPINFO-Benachrichtigungsnachricht sendet.
Die Funktion GetImageList member ruft das Handle der Bildliste eines Baumsteuerelements ab. Diese Funktion ist nützlich, wenn Sie der Liste weitere Bilder hinzufügen müssen. Weitere Informationen zu Bildlisten finden Sie unter Verwenden von CImageList, CImageList in der MFC-Referenz und Bildlisten im Windows SDK.