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.
Jedes Element wird als ein großes Symbol (32 x 32 Pixel) mit einer Bezeichnung darunter angezeigt. Der Benutzer kann die Elemente an eine beliebige Position in der Liste Ansicht ziehen.
Jedes Element wird als ein kleines Symbol (16 x 16 Pixel) mit der Bezeichnung rechts davon. Der Benutzer kann die Elemente an eine beliebige Position in der Liste Ansicht ziehen.
Jedes Element wird als ein kleines Symbol mit einer Bezeichnung rechts davon. Elemente in Spalten angeordnet sind und können nicht an eine beliebige Position in der Liste Ansicht gezogen werden.
Jedes Element wird in einer eigenen Zeile, mit zusätzlichen Informationen in Spalten auf der rechten Seite angeordnet. Die linke Spalte enthält das kleine Symbol und Beschriftung und nachfolgende Spalten enthalten Unterelemente von der Anwendung angegeben. Eines eingebetteten Headersteuerelements ( CHeaderCtrl-Klasse) implementiert diese Spalten. Weitere Informationen über das Kopfzeilen-Steuerelement und Spalten in einem Bericht anzeigen, finden Sie unter CListCtrl verwenden: Hinzufügen von Spalten an das Steuerelement (Bericht anzeigen).
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:
Wenn aktiviert, ermöglicht automatische Auswahl eines Elements, wenn der Cursor über dem Element für einen bestimmten Zeitraum bleibt.
Wenn aktiviert, kann das Steuerelement bis zu DWORD Elemente unterstützen. Dies ist möglich durch den Aufwand für das Verwalten von Daten über die Anwendung platzieren. Außer für die Auswahl von Elementen und Fokus Informationen muss Informationen über alle von der Anwendung verwaltet werden. Weitere Informationen finden Sie unter Verwenden von CListCtrl: Virtual List-Steuerelemente.
Wenn aktiviert, ermöglicht hot Track (automatische Hervorhebung des Elementtexts) und One– oder Two– klicken Sie auf Aktivierung des markierten Elements.
Wenn aktiviert, ermöglicht es, Drag-and-Drop neu anordnen von Spalten in einem Listenansicht-Steuerelement. Nur verfügbar in der Berichtsansicht.
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.:
Für Full-size-Symbole verwendet in der Symbolansicht.
Verwendet in die kleine Symbole, Liste und Berichtsansichten für kleinere Versionen der Symbole in der Symbolansicht verwendet.
Enthält Zustandsbilder, die neben das Symbol eines Elements an einen Anwendung definierte Zustand angezeigt werden.
Verwendet in der Berichtsansicht für kleine Bilder, die in jedem Element des Header-Steuerelements angezeigt werden.
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