Bilderliste für das Struktursteuerelement

Jedes Element in einem Struktursteuerelement (CTreeCtrl) kann ein Paar Bitmapbilder zugeordnet sein. 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 nicht ausgewählte Zustände 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.

Bildlisten eines Struktursteuerelements können auch Überlagerungsbilder enthalten, die für Elementbilder überlagert werden sollen. Ein Wert ungleich Null in Bits 8 bis 11 des Zustands eines Struktursteuerelementelements gibt den 1-basierten Index eines Überlagerungsbilds an (0 gibt kein Overlaybild an). Da ein 4-Bit-, ein 1-basierter Index verwendet wird, müssen Überlagerungsbilder zu den ersten 15 Bildern in den Bildlisten gehören. Weitere Informationen zu Struktursteuerelementelementzuständen finden Sie weiter oben in diesem Thema unter Übersicht über Struktursteuerelementelemente.

Wenn eine Statusbildliste angegeben wird, reserviert ein Struktursteuerelement Platz links neben dem Symbol jedes Elements für ein Zustandsbild. Eine Anwendung kann Zustandsbilder verwenden, z. B. aktivierte und deaktivierte Kontrollkästchen, um anwendungsdefinierte Elementzustände anzugeben. Ein Wert ungleich Null in Bits 12 bis 15 gibt den 1-basierten Index eines Zustandsbilds 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 leitet das Struktursteuerelement an, die Anwendung für den Index abzufragen, indem die TVN_GETDISPINFO-Benachrichtigung gesendet wird.

Die GetImageList-Memberfunktion ruft das Handle der Bildliste eines Struktursteuerelements 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.

Siehe auch

Verwenden von CTreeCtrl
Steuerelemente