Strukturansicht-Steuerelement-Bildlisten

Jedes Element in einem Strukturansicht-Steuerelement (CTreeCtrl) kann ein Paar Bitmapbilder haben zugeordnet.Die Bilder werden auf der linken Seite der Bezeichnung eines Elements.Ein Bild wird angezeigt, wenn das Element ausgewählt ist, und das andere wird angezeigt, wenn das Element nicht ausgewählt ist.Zum Beispiel könnte ein Element einen Ordner öffnen und auf, wenn es ein geschlossener Ordner ausgewählt wird, wenn sie nicht ausgewählt ist.

Um Element Bilder verwenden zu können, 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 die gewünschten Bitmap der Liste hinzu und ordnen Sie die Liste mit dem Strukturansicht-Steuerelement zu, indem Sie die SetImageList-Memberfunktion verwenden.Standardmäßig werden alle Elemente das erste Bilds in der Bildliste nicht aktiviert und für die ausgewählten Zustände an.Sie können das Standardverhalten für ein bestimmtes Element ändern, indem Sie die Indizes der ausgewählten Bilder ausgewählt und nicht angeben, wenn Sie das Element dem Strukturansicht-Steuerelement mithilfe der InsertItem-Memberfunktion hinzufügen.Sie können die Indizes ändern, nachdem Sie ein Element hinzugefügt haben, indem Sie die SetItemImage-Memberfunktion verwenden.

Die Bildlisten eines Strukturansicht-Steuerelements Overlay können auch Bilder enthalten, die ein Element Bilder gespeichert werden soll.Ein Wert ungleich 0 (null) in Bits 8 bis 11 vom Zustand eines Strukturansicht-Steuerelement-Elements gibt den einsbasierten Index eines Overlay Programmabbildern (0 gibt kein Bild Overlay angezeigt).Da ein 4-Bit, einsbasierter Index verwendet wird, müssen Overlay Bilder auf die ersten 15 Bildern in den Bildlisten gehören.Weitere Informationen zu Bedingungen finden Sie unter Strukturansicht-Steuerelement-Element Übersicht über gibt an Strukturansicht-Steuerelement-Element weiter oben in diesem Thema.

Wenn eine bildliste Status angegeben ist, reserviert Speicherplatz ein Strukturansicht-Steuerelement auf der linken Seite des Symbols Status jedes Elements für ein Bild.Eine Anwendung kann, z. B. Bilder im aktivierten Zustand und gelöschte Kontrollkästchen anwendungsdefinierte Element verwenden, um Bedingungen anzugeben.Ein Wert ungleich 0 (null) in Bits 12 bis 15 für den einsbasierten Index eines Zustands Programmabbildern (0 gibt kein Bild Zustand an).

Indem Sie den Wert I_IMAGECALLBACK anstelle des Index eines Bildes angeben, können Sie das ausgewählte Bild nicht ausgewählt oder verzögert werden, bis das Element anzugeben gerade neu gezeichnet werden sollen.I_IMAGECALLBACK verweist auf das Struktursteuerelement, die Anwendung für den Index unter Verwendung der Abfrage TVN_GETDISPINFO Benachrichtigungsmeldung gesendet werden.

Die GetImageList-Memberfunktion ruft das Handle der Bildliste eines Strukturansicht-Steuerelements ab.Diese Funktion ist hilfreich, wenn Sie mehrere Bilder hinzufügen müssen.Weitere Informationen über Bildlisten finden Sie unter Verwenden von CImageList, CImageList in der MFC-Referenz und Bildlisten in Windows SDK.

Siehe auch

Referenz

Verwenden von CTreeCtrl

Konzepte

Steuerelemente (MFC)