CListCtrl

Die CListCtrl -Klasse kapselt die Funktionalität von einem "Listenansicht-Steuerelement," welche zeigt eine Auflistung der Elemente jeweils ein Symbol (aus einer Bildliste) und ein Label aus. Jedes Element kann zusätzlich zu einem Symbol und Beschriftung Informationen in Spalten rechts neben das Symbol und Bezeichnung angezeigt haben. Dieses Steuerelement (und somit der Klasse CListCtrl ) ist nur für Programme, die unter Windows 95 und Windows NT Version 3.51 und höher.

Es folgt eine kurze Übersicht über die CListCtrl -Klasse. Eine detaillierte und konzeptionelle Diskussion, finden Sie unter Verwenden von CListCtrl und Kontrolle Themen im Visual C++ Programmer's Guide.

Ansichten

Listenansicht-Steuerelemente können auf vier verschiedene Arten, genannt "Ansichten." ihren Inhalt anzuzeigen.

Den Stil der aktuellen Listen-Ansicht des Steuerelements bestimmt die aktuelle Ansicht. Weitere Informationen über diese diese Stile und deren Verwendung finden Sie unter Verwenden von CListCtrl: Ändern der Liste Steuerelement Formatvorlagen.

Erweiterte Stile

Zusätzlich zu der Listenformatvorlagen unterstützt CListCtrl -Klasse eine Reihe von erweiterten Stile, erweiterte Funktionalität. Einige Beispiele für diese Funktion:

Informationen über diese neue Stile erweitert, finden Sie unter Verwenden von CListCtrl: Ändern der Liste Steuerelement Formatvorlagen.

Elemente und Unterelemente

Jedes Element in einer Listenansicht-Steuerelement besteht aus ein Symbol (aus einer Bildliste), eine Bezeichnung, ein Stand und ein anwendungsdefinierter Wert ("Elementdaten" genannt). Einem oder mehreren Unterelementen können auch mit jedem Element zugeordnet werden. Ein "Unterelement" ist eine Zeichenfolge, die in einer Spalte rechts vom Symbol und Bezeichnung eines Elements in der Berichtsansicht angezeigt werden kann. Alle Elemente in einem Listenansicht-Steuerelement müssen die gleiche Anzahl von Unterelementen.

Klasse CListCtrl bietet mehrere Funktionen zum Einfügen, löschen, suchen und diese Elemente ändern. Weitere Informationen finden Sie unter CListCtrl::GetItem, CListCtrl::InsertItemund CListCtrl::FindItem, CListCtrl verwenden: Hinzufügen von Elementen zum Steuerelement, und Verwenden von CListCtrl: Scrollen, anordnen, Sortieren und suchen in Listen-Steuerelemente.

Standardmäßig ist das Listenansicht-Steuerelement für ein Element-Symbol und Text Attribute gespeichert. Klasse CListCtrl unterstützt jedoch zusätzlich zu diesen Elementtypen, "Rückrufelemente." Ein "Rückruf" folgt einem Listenansichtselement für die die Anwendung — anstatt das Steuerelement — speichert den Text und/oder Symbol. Eine Rückrufmaske wird verwendet, um anzugeben, welche Attribute der Items (Text und/oder Symbol) von der Anwendung bereitgestellt werden. Wenn eine Anwendung Rückrufelemente verwendet, muss es die Attribute Text und/oder Symbol auf Nachfrage liefern können. Rückrufelemente sind hilfreich, wenn die Anwendung bereits einige dieser Informationen verwaltet. Weitere Informationen finden Sie unter CListCtrl::GetCallBackMask und Verwenden von CListCtrl: Rückrufelemente und die Rückrufmaske.

Bildlisten

Die Symbole, Header Elementbilder und Anbringens Staaten für Listenansicht, die Elemente enthalten sind in mehrere Bildlisten (von CImageList-Klasse implementiert), die Sie erstellen, und weisen Sie das Listenansicht-Steuerelement definiert. Jede Listenansicht-Steuerelement kann bis zu vier verschiedene Typen von Bildlisten haben.:

In der Standardeinstellung zerstört ein Listenansicht-Steuerelement die Bildliste zugeordnet, wenn es zerstört wird; der Entwickler kann jedoch dieses Verhalten anpassen, indem zerstören jede Bildliste, wenn es nicht mehr verwendet wird, wie von der Anwendung bestimmt. Weitere Informationen finden Sie unter Verwenden von CListCtrl: Bild Listen und Listenelemente und Verwenden von CListCtrl: Bild Listen und Listenelemente.

# include lt;afxcmn.h>

Klasse&nmember |nbsp; Basisklasse | Hierarchiediagramm

Proben&Nbsp; MFC-Beispiel DAOTABLE | MFC-Beispiel HTTPSVR | MFC-Beispiel LISTHDR | MFC-Beispiel ROWLIST | MFC-Beispiel DBVLIST

Siehe auch&Nbsp;CImageList

Index