CListCtrl-Klasse

Artikel
06/10/2015

Kapselt die Funktionalität eines Listenansicht-Steuerelements "," zeigt das eine Auflistung Elemente jede an, die einem Symbol besteht (von einer Bildliste) und einer Bezeichnung.

class CListCtrl : public CWnd

Mitglieder

Öffentliche Konstruktoren

Name	Description
CListCtrl::CListCtrl	Erstellt ein CListCtrl-Objekt.

Öffentliche Methoden

Name	Description
CListCtrl::ApproximateViewRect	Bestimmt die Breite und Höhe, die erforderlich sind, um die Elemente eines Listenansicht-Steuerelements anzuzeigen.
CListCtrl::Arrange	Richtet Elemente in einem Raster aus.
CListCtrl::CancelEditLabel	Bricht Elementtextbearbeitungsvorgang ab.
CListCtrl::Create	Erstellt ein Listensteuerelement und fügt es zu einem CListCtrl-Objekt.
CListCtrl::CreateDragImage	Erstellt eine Ziehbildliste für ein angegebenes Element.
CListCtrl::CreateEx	Erstellt ein Listensteuerelement mit den angegebenen Windows-erweitertenFormaten und fügt es zu einem CListCtrl-Objekt.
CListCtrl::DeleteAllItems	Löscht alle Elemente aus dem Steuerelement.
CListCtrl::DeleteColumn	Löscht eine Spalte aus dem ListView-Steuerelement.
CListCtrl::DeleteItem	Löscht ein Element des Steuerelements.
CListCtrl::DrawItem	Aufgerufen wenn ein visueller Aspekt von Ownerdrawnsteueränderungen.
CListCtrl::EditLabel	Startet die direkte Bearbeitung Text eines Elements.
CListCtrl::EnableGroupView	Aktiviert oder deaktiviert die ob Elemente in einer Listenansicht, die als Gruppe Anzeige ist.
CListCtrl::EnsureVisible	Stellt sicher, dass ein Element sichtbar ist.
CListCtrl::FindItem	Suchen nach einem Listenansichtelement, das Eigenschaften angegeben wird.
CListCtrl::GetBkColor	Ruft die Hintergrundfarbe eines Listenansicht-Steuerelements ab.
CListCtrl::GetBkImage	Ruft das aktuelle Hintergrundbild eines Listenansicht-Steuerelements ab.
CListCtrl::GetCallbackMask	Ruft die Rückrufmaske für ein Listenansicht-Steuerelement ab.
CListCtrl::GetCheck	Ruft den aktuellen Anzeigenstatus des die Zustandsbilder ab, das einem Element zugeordnet ist.
CListCtrl::GetColumn	Ruft die Attribute einer Spalte des ab.
CListCtrl::GetColumnOrderArray	Ruft die Spaltenreihenfolge (von links nach rechts) eines Listenansicht-Steuerelements ab.
CListCtrl::GetColumnWidth	Ruft die Breite einer Spalte in der Berichtsansicht oder -Listenansicht ab.
CListCtrl::GetCountPerPage	Berechnet die Anzahl von Elementen, die in ein ListView-Steuerelement vertikal anpassen können.
CListCtrl::GetEditControl	Ruft das Handle des Bearbeitungssteuerelements ab, das verwendet wird, um den Text eines Elements zu bearbeiten.
CListCtrl::GetEmptyText	Ruft die Zeichenfolge ab, die angezeigt werden, wenn das aktuelle Listenansicht-Steuerelement leer ist.
CListCtrl::GetExtendedStyle	Ruft die aktuellen erweiterten Formate eines Listenansicht-Steuerelements ab.
CListCtrl::GetFirstSelectedItemPosition	Ruft die Position des ersten ausgewählten Listenansichtelements in einem ListView-Steuerelement ab.
CListCtrl::GetFocusedGroup	Ruft die Gruppe ab, die den Tastaturfokus im aktuellen Listenansicht-Steuerelement verfügt.
CListCtrl::GetGroupCount	Ruft die Anzahl von Gruppen im aktuellen Listenansicht-Steuerelement ab.
CListCtrl::GetGroupInfo	Ruft die Informationen für eine angegebene Gruppe des Listenansicht-Steuerelements ab.
CListCtrl::GetGroupInfoByIndex	Ruft Informationen über eine bestimmte Gruppe im aktuellen Listenansicht-Steuerelement ab.
CListCtrl::GetGroupMetrics	Ruft die Metriken einer Gruppe ab.
CListCtrl::GetGroupRect	Ruft das umschließende Rechteck für eine angegebene Gruppe im aktuellen Listenansicht-Steuerelement ab.
CListCtrl::GetGroupState	Ruft den Zustand für eine angegebene Gruppe im aktuellen Listenansicht-Steuerelement ab.
CListCtrl::GetHeaderCtrl	Ruft das Header-Steuerelement eines Listenansicht-Steuerelements ab.
CListCtrl::GetHotCursor	Ruft den verwendeten Cursor ab, wenn das Hottracking für ein Listenansicht-Steuerelement aktiviert ist.
CListCtrl::GetHotItem	Ruft das Listenansichtelement direkt unter dem Cursor ab.
CListCtrl::GetHoverTime	Ruft die aktuelle Hoverzeit eines Listenansicht-Steuerelements ab.
CListCtrl::GetImageList	Ruft das Handle einer Bildliste ab, die zum Zeichnen von Listenansichtelementen verwendet wird.
CListCtrl::GetInsertMark	Ruft die aktuelle Position der Einfügemarke ab.
CListCtrl::GetInsertMarkColor	Ruft die aktuelle Farbe der Einfügemarke ab.
CListCtrl::GetInsertMarkRect	Ruft das Rechteck ab, die die Einfügemarke begrenzt.
CListCtrl::GetItem	Ruft die Attribute eines Listenansichtelements ab.
CListCtrl::GetItemCount	Ruft die Anzahl der Elemente in einem ListView-Steuerelement ab.
CListCtrl::GetItemData	Ruft den anwendungsspezifischen Wert ab, der einem Element zugeordnet ist.
CListCtrl::GetItemIndexRect	Ruft das umschließende Rechteck für alle oder nur einen Teil eines Unterelements im aktuellen Listenansicht-Steuerelement ab.
CListCtrl::GetItemPosition	Ruft die Position eines Listenansichtelements ab.
CListCtrl::GetItemRect	Ruft das umschließende Rechteck für ein Element ab.
CListCtrl::GetItemSpacing	Berechnet den Abstand zwischen Elementen im aktuellen Listenansicht-Steuerelement.
CListCtrl::GetItemState	Ruft den Zustand eines Listenansichtelements ab.
CListCtrl::GetItemText	Ruft den Text eines Listenansichtelements oder des Unterelements ab.
CListCtrl::GetNextItem	Suchen nach einem Listenansichtelement mit angegebenen Eigenschaften und mit angegebener Beziehung zu einem angegebenen Element.
CListCtrl::GetNextItemIndex	Ruft den Index des Elements im aktuellen Listenansicht-Steuerelement ab, das einen angegebenen Satz von Eigenschaften verfügt.
CListCtrl::GetNextSelectedItem	Ruft den Index einer Listenansichtelementposition und die Position des folgenden ausgewählten Listenansichtelements zum Durchlaufen ab.
CListCtrl::GetNumberOfWorkAreas	Ruft die aktuelle Anzahl von Arbeitsbereichen für ein Listenansicht-Steuerelement ab.
CListCtrl::GetOrigin	Ruft den Ursprung der aktuellen Ansicht ein Listenansicht-Steuerelement ab.
CListCtrl::GetOutlineColor	Ruft die Farbe des Rahmens eines Listenansicht-Steuerelements ab.
CListCtrl::GetSelectedColumn	Ruft den Index der ausgewählten Spalte im Listensteuerelement ab.
CListCtrl::GetSelectedCount	Ruft die Anzahl der ausgewählten Elemente im ListView-Steuerelement ab.
CListCtrl::GetSelectionMark	Ruft die Auswahlmarke eines Listenansicht-Steuerelements ab.
CListCtrl::GetStringWidth	Bestimmt die minimale Spaltenbreite, die erforderlich ist, die ganze angegebene Zeichenfolge anzuzeigen.
CListCtrl::GetSubItemRect	Ruft das umgebende Rechteck eines Elements in einem ListView-Steuerelement ab.
CListCtrl::GetTextBkColor	Ruft die Texthintergrundfarbe eines Listenansicht-Steuerelements ab.
CListCtrl::GetTextColor	Ruft die Textfarbe eines Listenansicht-Steuerelements ab.
CListCtrl::GetTileInfo	Ruft Informationen zu einer Kachel in einem ListView-Steuerelement ab.
CListCtrl::GetTileViewInfo	Ruft Informationen über ein Listenansicht-Steuerelement in der Tile-Ansicht ab.
CListCtrl::GetToolTips	Ruft das QuickInfosteuerelement ab, dem das ListView-Steuerelement verwendet, um QuickInfo anzuzeigen.
CListCtrl::GetTopIndex	Ruft den Index des obersten sichtbaren Elements ab.
CListCtrl::GetView	Ruft die Ansicht des Listenansicht-Steuerelements ab.
CListCtrl::GetViewRect	Ruft das umschließende Rechteck aller Elemente im ListView-Steuerelement ab.
CListCtrl::GetWorkAreas	Ruft die aktuellen Arbeitsbereiche eines Listenansicht-Steuerelements ab.
CListCtrl::HasGroup	Bestimmt, ob das ListView-Steuerelement die angegebene Gruppe verfügt.
CListCtrl::HitTest	Bestimmt, das Listenansichtelement in einer angegebenen Position befindet.
CListCtrl::InsertColumn	Fügt eine neue Spalte in einem ListView-Steuerelement ein.
CListCtrl::InsertGroup	Fügt eine Gruppe in das ListView-Steuerelement ein.
CListCtrl::InsertGroupSorted	Fügt die angegebene Gruppe in eine sortierte Liste von Gruppen ein.
CListCtrl::InsertItem	Fügt ein neues Element in einem ListView-Steuerelement ein.
CListCtrl::InsertMarkHitTest	Ruft die Einfügemarke ab, die einem angegebenen Punkt am nächsten ist.
CListCtrl::IsGroupViewEnabled	Bestimmt, ob Gruppenansicht für ein Listenansicht-Steuerelement aktiviert ist.
CListCtrl::IsItemVisible	Gibt an, ob ein angegebenes Element im aktuellen Listenansicht-Steuerelement sichtbar ist.
CListCtrl::MapIDToIndex	Ordnet die eindeutige ID eines Elements im aktuellen Listenansicht-Steuerelement zu einem Index zu.
CListCtrl::MapIndexToID	Ordnet den Index eines Elements im aktuellen Listenansicht-Steuerelement auf eine eindeutige ID zu
CListCtrl::MoveGroup	Befördert die angegebene Gruppe.
CListCtrl::MoveItemToGroup	Verschiebt die angegebene Gruppe auf den angegebenen nullbasierten Index des Listenansicht-Steuerelements.
CListCtrl::RedrawItems	Erzwingt ein ListView-Steuerelement, um einen Bereich von Elementen neu zu zeichnen.
CListCtrl::RemoveAllGroups	Entfernt alle Gruppen aus einem Listenansicht-Steuerelement.
CListCtrl::RemoveGroup	Entfernt die angegebene Gruppe im ListView-Steuerelement.
CListCtrl::Scroll	Führt den Inhalt eines Listenansicht-Steuerelements aus.
CListCtrl::SetBkColor	Legt die Hintergrundfarbe des Listenansicht-Steuerelements fest.
CListCtrl::SetBkImage	Legt das aktuelle Hintergrundbild eines Listenansicht-Steuerelements fest.
CListCtrl::SetCallbackMask	Legt die Rückrufmaske für ein Listenansicht-Steuerelement fest.
CListCtrl::SetCheck	Legt den aktuellen Anzeigenstatus des die Zustandsbilder fest, das einem Element zugeordnet ist.
CListCtrl::SetColumn	Legt die Attribute einer Listenansichtsspalte fest.
CListCtrl::SetColumnOrderArray	Legt die Spaltenreihenfolge (von links nach rechts) eines Listenansicht-Steuerelements fest.
CListCtrl::SetColumnWidth	Ändert die Breite einer Spalte in der Berichtsansicht oder -Listenansicht.
CListCtrl::SetExtendedStyle	Legt die aktuellen erweiterten Formate eines Listenansicht-Steuerelements fest.
CListCtrl::SetGroupInfo	Legt die Informationen für die angegebene Gruppe eines Listenansicht-Steuerelements fest.
CListCtrl::SetGroupMetrics	Legt die Gruppenmetrik eines Listenansicht-Steuerelements fest.
CListCtrl::SetHotCursor	Legt den verwendeten Cursor fest, wenn das Hottracking für ein Listenansicht-Steuerelement aktiviert ist.
CListCtrl::SetHotItem	Legt das aktuelle hervorgehobene Element eines Listenansicht-Steuerelements fest.
CListCtrl::SetHoverTime	Legt die aktuelle Hoverzeit eines Listenansicht-Steuerelements fest.
CListCtrl::SetIconSpacing	Legt den Abstand zwischen Symbolen in einem ListView-Steuerelement fest.
CListCtrl::SetImageList	Weist eine Bildliste zu einem Listenansicht-Steuerelement zu.
CListCtrl::SetInfoTip	Legt den QuickInfo-Text fest.
CListCtrl::SetInsertMark	Legt die Einfügemarke zur definierten Position fest.
CListCtrl::SetInsertMarkColor	Legt die Farbe der Einfügemarke fest.
CListCtrl::SetItem	Legt mehrere oder alle Attribute eines Listenansichtelements fest.
CListCtrl::SetItemCount	Bereitet ein ListView-Steuerelement zum Hinzufügen vieler Elemente vor.
CListCtrl::SetItemCountEx	Legt die Elementanzahl für ein virtuelles Listenansicht-Steuerelement fest.
CListCtrl::SetItemData	Legt den anwendungsspezifischen Wert des Elements fest.
CListCtrl::SetItemIndexState	Legt den Zustand eines Elements im aktuellen Listenansicht-Steuerelement fest.
CListCtrl::SetItemPosition	Verschiebt ein Element an eine angegebene Position in einem ListView-Steuerelement.
CListCtrl::SetItemState	Ändert den Zustand eines Elements in einem ListView-Steuerelement.
CListCtrl::SetItemText	Ändert den Text eines Listenansichtelements oder des Unterelements.
CListCtrl::SetOutlineColor	Legt die Farbe des Rahmens eines Listenansicht-Steuerelements fest.
CListCtrl::SetSelectedColumn	Legt die ausgewählte Spalte des Listenansicht-Steuerelements fest.
CListCtrl::SetSelectionMark	Legt die Auswahlmarke eines Listenansicht-Steuerelements fest.
CListCtrl::SetTextBkColor	Legt die Hintergrundfarbe des Texts in einem ListView-Steuerelement fest.
CListCtrl::SetTextColor	Legt die Textfarbe eines Listenansicht-Steuerelements fest.
CListCtrl::SetTileInfo	Legt die Informationen für eine Kachel des Listenansicht-Steuerelements fest.
CListCtrl::SetTileViewInfo	Enthält Informationen fest, die ein Listenansicht-Steuerelement in der Tile-Ansicht verwendet.
CListCtrl::SetToolTips	Legt das QuickInfosteuerelement fest, dem das ListView-Steuerelement verwendet, um QuickInfo anzuzeigen.
CListCtrl::SetView	Legt die Ansicht des Listenansicht-Steuerelements fest.
CListCtrl::SetWorkAreas	Legt den Bereich fest, in dem Symbole in einem ListView-Steuerelement angezeigt werden können.
CListCtrl::SortGroups	Sortiert die Gruppen eines Listenansicht-Steuerelements mit einer benutzerdefinierten Funktion.
CListCtrl::SortItems	Sortiert Listenansichtelemente mithilfe einer anwendungsdefinierten Vergleichsfunktion.
CListCtrl::SortItemsEx	Sortiert Listenansichtelemente mithilfe einer anwendungsdefinierten Vergleichsfunktion.
CListCtrl::SubItemHitTest	Bestimmt, die Listenansichtelement ggf. an einer angegebenen Position befindet.
CListCtrl::Update	Erzwingt das Steuerelement, um ein bestimmtes Element neu zu zeichnen.

Hinweise

Zusätzlich zu einem Symbol und eine Bezeichnung kann jedes Element die Informationen verfügen, die in den Spalten auf der rechten Seite des Symbols und der Bezeichnung angezeigt werden. Dieses Steuerelement (und daher die CListCtrl-Klasse) ist nur für - Programmen verfügbar, die unter Windows 95/98- und Windows NT 3,51 und höher ausgeführt werden.

Es folgt eine kurze Übersicht über die CListCtrl-Klasse. Eine ausführliche Erläuterung, konzeptionelle finden Sie unter Verwenden CListCtrl und Steuerelemente.

Ansichten

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

Symbolen

Jedes Element wird als Pixel des Symbols (32 x 32 an) mit einer Bezeichnung unter es. Der Benutzer kann Elemente zu einem Speicherort im Listenansichtsfenster ziehen.
Kleine Symbolen

Jedes Element wird als kleinen Pixel des Symbols (16 x 16) mit der Bezeichnung auf der rechten Seite dieses. Der Benutzer kann Elemente zu einem Speicherort im Listenansichtsfenster ziehen.
Listenansicht

Jedes Element wird als kleines Symbol mit einer Bezeichnung auf der rechten Seite dieses. Elemente werden in Spalten angeordnet und können nicht zu einem Speicherort im Listenansichtsfenster gezogen werden.
Berichtsansicht

Jedes Element wird in einer eigenen Zeile, wenn die zusätzliche Informationen in Spalten angeordnet ist, rechts. Die Spalte ganz links enthält das kleine Symbol und die Bezeichnung, und folgende Spalten enthalten Unterelemente, wie durch die Anwendung angegeben. Ein eingebettetes Header-Steuerelement (- Klasse) Steuerelement-MFC-Klassen implementiert diese Spalten. Weitere Informationen über das Header-Steuerelement und Spalten in einer Berichtsansicht, finden Sie unter Verwenden CListCtrl: Spalten auf das Steuerelement (Berichtsansicht) hinzufügen.

Siehe auch:

Knowledge Base-Artikel Q250614: HOWTO: Sortierungs-Elemente in einem CListCtrl in der Berichtsansicht
Knowledge Base-Artikel Q200054: PRB: OnTimer() wird wiederholt nicht für ein Listensteuerelement aufgerufen

Das Format der aktuellen Listenansicht des Steuerelements bestimmt die aktuelle Ansicht. Weitere Informationen zu diesen sieht Formate und ihre Verwendung, Verwenden CListCtrl: Ändern von Listensteuerelement-Formaten.

Erweiterte Stile

Zusätzlich zu den Standardlistenformaten unterstützt Klasse CListCtrl einen umfangreichen Satz erweiterte Formate und stellt angereicherte Funktionalität bereit. Einige Beispiele für diese Funktionalität:

Verschiebung des Mauszeigerss-Auswahl

Wenn Sie aktiviert sind, lässt die automatische Auswahl eines Elements, wenn der Cursor über dem Element während eines bestimmten Zeitraums bleibt.
Virtuelle Listenansichten

Wenn Sie aktiviert werden, ermöglicht es dem Steuerelement, um bis zu DWORD-Elemente zu unterstützen. Dies ist möglich, indem Sie den Aufwand für die Verwaltung von Elementdaten auf der Anwendung platziert. Neben der die Auswahl von Elementen und den Fokuseninformationen müssen alle Elementinformationen von der Anwendung verwaltet werden. Weitere Informationen finden Sie unter Verwenden CListCtrl: Virtuelle Listensteuerelemente.
Aktivierung mit ein und zwei Klicken

Wenn Sie aktiviert sind, lässt das Hottracking (automatische Hervorhebung des Elementtexts) und die Aktivierung mit ein oder zwei Klicken des markierten Elements.
Drag & Drop-Spaltenreihenfolge

Wenn Sie aktiviert sind, lässt das Drag & Drop-Neuanordnen von Spalten in einem ListView-Steuerelement. Nur verfügbar in der Berichtsansicht.

Informationen zur Verwendung dieser neuen erweiterten Stile, finden Sie unter Verwenden CListCtrl: Ändern von Listensteuerelement-Formaten.

Elemente und Unterelemente

Jedes Element in einem ListView-Steuerelement besteht aus einem Symbol (von einer Bildliste), eine Bezeichnung, einem aktuellen Zustand und einem anwendungsdefinierten Wert (bezeichnet als "Elementdaten"). Eine oder mehrere Unterelemente können mit jedem Element auch zugeordnet werden. Ein "Unterelement" ist eine Zeichenfolge, die, in der Berichtsansicht, in einer Spalte auf der rechten Seite des Symbols und der Bezeichnung eines Elements angezeigt werden kann. Alle Elemente in einem ListView-Steuerelement müssen die gleiche Anzahl von Unterelementen haben.

- Klasse CListCtrl stellt mehrere Funktionen zum Einfügen, Löschen, Durchsuchen und Ändern dieser Elemente bereit. Weitere Informationen finden Sie unter CListCtrl::GetItem, CListCtrl::InsertItem und CListCtrl::FindItem, Verwenden CListCtrl: Hinzufügen von Elementen zum Steuerelement und Verwenden CListCtrl: wechseln, Anordnen, Sortieren und Suchen in Listen-Steuerelemente.

Standardmäßig ist das ListView-Steuerelement zum Speichern von Symbol- und Textattributen eines Elements zuständig. jedoch zusätzlich zu diesen Elementtypen, unterstützt die Klasse CListCtrl "Rückrufelemente." Ein "Rückrufelement" ist ein Listenansichtelement, für das die Anwendung - anstelle des Steuerelement Speicher für Text, das Symbol oder beide. Eine Rückrufmaske wird verwendet, um anzugeben, die Elementattribute (Text und/oder Symbol) durch die Anwendung angegeben werden. Wenn eine Anwendung Rückrufelemente verwendet, muss es in der Lage sein, die Text- und/oder Symbolattribute bei Bedarf an. Rückrufelemente sind hilfreich, wenn die Anwendung bereits einige dieser Informationen aufrechterhält. Weitere Informationen finden Sie unter Verwenden CListCtrl: Rückruf-Elemente und die Rückruf-Maske.

Bildlisten

Die Symbole, die Headerelementimages und anwendungsdefinierte Zustände für Listenansichtelemente werden in mehreren Grafiklisten (implementiert durch Klasse CImageList) enthalten, die Sie dem ListView-Steuerelement erstellen und zuweisen. Jedes Listenansicht-Steuerelement kann bis zu vier verschiedene Typen Bildlisten haben:

Großes Symbol

Wird in der Symbolen für Symbole an.
Kleines Symbol

Wird im kleinen Symbol, in der Liste und in den Berichtsansichten für kleinere Versionen der Symbole verwendet in der Symbolen angezeigt.
Anwendungsdefinierter Zustand

Enthält die Zustandsbilder, die neben dem Symbol eines Elements werden angezeigt, um einen anwendungsdefinierten Zustand anzugeben.
Headerelement

Wird in der Berichtsansicht für kleine Bilder, die in jedem Header-Steuerelement-Element angezeigt werden.

Standardmäßig zerstört ein ListView-Steuerelement die Bildlisten, die zugewiesen werden, wenn es zerstört wird, kann jedoch der Entwickler dieses Verhalten, indem jede Bildliste, wenn er nicht mehr verwendet wird, wie durch die Anwendung bestimmt anpassen zerstört. Weitere Informationen finden Sie unter Verwenden CListCtrl: Listenelemente und Bildlisten.