CMFCListCtrl-Klasse
Die CMFCListCtrl Klasse erweitert die Funktionalität der CListCtrl Klasse , indem die erweiterte Headersteuerelementfunktion der CMFCHeaderCtrl Klasse unterstützt wird.
Syntax
class CMFCListCtrl : public CListCtrl
Member
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
CMFCListCtrl::EnableMarkSortedColumn |
Ermöglicht das Markieren einer sortierten Spalte mit einer anderen Hintergrundfarbe. |
CMFCListCtrl::EnableMultipleSort |
Aktiviert den Mehrfachsortierungsmodus. |
CMFCListCtrl::GetHeaderCtrl |
Gibt einen Verweis auf das unterstrichene Kopfzeilensteuerelement zurück. |
CMFCListCtrl::IsMultipleSort |
Überprüft, ob sich das Listensteuerelement im mehrfachen Sortiermodus befindet. |
CMFCListCtrl::OnCompareItems |
Wird vom Framework aufgerufen, wenn zwei Listensteuerelementelemente verglichen werden müssen. |
CMFCListCtrl::OnGetCellBkColor |
Wird vom Framework aufgerufen, wenn die Hintergrundfarbe einer einzelnen Zelle bestimmt werden muss. |
CMFCListCtrl::OnGetCellFont |
Wird vom Framework aufgerufen, wenn die Schriftart für die zu zeichnende Zelle abgerufen werden muss. |
CMFCListCtrl::OnGetCellTextColor |
Wird vom Rahmen aufgerufen, wenn die Textfarbe einer einzelnen Zelle bestimmt werden muss. |
CMFCListCtrl::RemoveSortColumn |
Entfernt eine Sortierspalte aus der Liste sortierter Spalten. |
CMFCListCtrl::SetSortColumn |
Legt die aktuelle sortierte Spalte und die Sortierreihenfolge fest. |
CMFCListCtrl::Sort |
Sortiert das Listensteuerelement. |
Hinweise
CMFCListCtrl bietet zwei Verbesserungen an CListCtrl der Klasse . Zunächst wird angegeben, dass die Spaltensortierung eine verfügbare Option ist, indem automatisch ein Sortierpfeil auf der Kopfzeile gezeichnet wird. Zweitens wird die Datensortierung auf mehreren Spalten gleichzeitig unterstützt.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CMFCListCtrl -Klasse. Das Beispiel zeigt, wie Sie ein Listensteuerelement erstellen, Spalten einfügen, Elemente einfügen, den Text eines Elements festlegen und die Schriftart des Listensteuerelements festlegen. Dieser Codeausschnitt ist Teil des Visual Studio Demo-Beispiels.
CMFCListCtrl m_wndWatch;
// DWORD dwStyle
// CRect rectDummy
m_wndWatch.Create(dwStyle, rectDummy, this, ID_LIST_1);
m_wndWatch.SendMessage(LVM_SETEXTENDEDLISTVIEWSTYLE, 0, LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);
m_wndWatch.InsertColumn(0, _T("Variable"), LVCFMT_LEFT, 100);
m_wndWatch.InsertColumn(1, _T("Value"), LVCFMT_LEFT, 100);
m_wndWatch.InsertItem(0, _T("m_nCount"));
m_wndWatch.SetItemText(0, 1, _T("100"));
m_wndWatch.SetFont(&m_Font);
Vererbungshierarchie
Anforderungen
Headerafxlistctrl.h:
CMFCListCtrl::EnableMarkSortedColumn
Markiert die sortierten Spalten mit einer anderen Hintergrundfarbe.
void EnableMarkSortedColumn(
BOOL bMark = TRUE,
BOOL bRedraw = TRUE);
Parameter
bMark
[in] Ein boolescher Parameter, der bestimmt, ob eine andere Hintergrundfarbe aktiviert werden soll.
bRedraw
[in] Ein boolescher Parameter, der bestimmt, ob das Steuerelement sofort neu gezeichnet werden soll.
Hinweise
EnableMarkSortedColumn verwendet die Methode CDrawingManager::PixelAlpha , um zu berechnen, welche Farbe für sortierte Spalten verwendet werden soll. Die ausgewählte Farbe basiert auf der normalen Hintergrundfarbe.
CMFCListCtrl::EnableMultipleSort
Ermöglicht das Sortieren der Datenzeilen im Listensteuerelement nach mehreren Spalten.
void EnableMultipleSort(BOOL bEnable = TRUE);
Parameter
bEnable
[in] Ein Boolescher Wert, der angibt, ob der Sortiermodus für mehrere Spalten aktiviert werden soll.
Hinweise
Wenn Sie die Sortierung basierend auf mehreren Spalten aktivieren, verfügen die Spalten über eine Hierarchie. Die Datenzeilen werden zuerst nach der primären Spalte sortiert. Alle entsprechenden Werte werden dann nach jeder nachfolgenden Spalte basierend auf der Priorität sortiert.
CMFCListCtrl::GetHeaderCtrl
Gibt einen Verweis auf das Kopfzeilensteuerelement zurück.
virtual CMFCHeaderCtrl& GetHeaderCtrl();
Rückgabewert
Ein Verweis auf das zugrunde liegende CMFCHeaderCtrl Objekt.
Hinweise
Das Kopfzeilensteuerelement für ein Listensteuerelement ist das Fenster, das die Titel für die Spalten enthält. Sie wird in der Regel direkt über den Spalten positioniert.
CMFCListCtrl::IsMultipleSort
Überprüft, ob das Listensteuerelement derzeit das Sortieren nach mehreren Spalten unterstützt.
BOOL IsMultipleSort() const;
Rückgabewert
TRUE wenn das Listensteuerelement mehrere Sortierungen unterstützt; FALSE Andernfalls.
Hinweise
Wenn eine CMFCListCtrl Klasse mehrere Sortierungen unterstützt, kann der Benutzer die Daten im Listensteuerelement nach mehreren Spalten sortieren. Rufen Sie auf, um CMFCListCtrl::EnableMultipleSortmehrere Sortierungen zu aktivieren.
CMFCListCtrl::OnCompareItems
Das Framework ruft diese Methode auf, wenn sie zwei Elemente vergleicht.
virtual int OnCompareItems(
LPARAM lParam1,
LPARAM lParam2,
int iColumn);
Parameter
lParam1
[in] Das erste zu vergleichende Element.
lParam2
[in] Das zweite zu vergleichende Element.
iColumn
[in] Der Index der Spalte, die diese Methode sortiert.
Rückgabewert
Eine ganze Zahl, die die relative Position der beiden Elemente angibt. Ein negativer Wert gibt an, dass das erste Element dem zweiten vorangestellt werden soll, ein positiver Wert gibt an, dass das erste Element auf die zweite folgen soll, und null bedeutet, dass die beiden Elemente gleichwertig sind.
Hinweise
Die Standardimplementierung gibt immer 0 zurück. Überschreiben Sie diese Funktion, um Ihren eigenen Sortieralgorithmus bereitzustellen.
CMFCListCtrl::OnGetCellBkColor
Das Framework ruft diese Methode auf, wenn sie die Hintergrundfarbe einer einzelnen Zelle bestimmen muss.
virtual COLORREF OnGetCellBkColor(
int nRow,
int nColumn);
Parameter
nRow
[in] Die Zeile der betreffenden Zelle.
nColumn
[in] Die Spalte der betreffenden Zelle.
Rückgabewert
Ein COLOREF Wert, der die Hintergrundfarbe der Zelle angibt.
Hinweise
Die Standardimplementierung verwendet OnGetCellBkColor nicht die bereitgestellten Eingabeparameter und ruft stattdessen einfach auf GetBkColor. Daher hat das gesamte Listensteuerelement standardmäßig dieselbe Hintergrundfarbe. Sie können in einer abgeleiteten Klasse außer Kraft setzen OnGetCellBkColor , um einzelne Zellen mit einer separaten Hintergrundfarbe zu markieren.
CMFCListCtrl::OnGetCellFont
Das Framework ruft diese Methode auf, wenn sie die Schriftart für eine einzelne Zelle abruft.
virtual HFONT OnGetCellFont(
int nRow,
int nColumn,
DWORD dwData = 0);
Parameter
nRow
[in] Die Zeile der betreffenden Zelle.
nColumn
[in] Die Spalte der betreffenden Zelle.
dwData
[in] Benutzerdefinierte Daten. Die Standardimplementierung verwendet diesen Parameter nicht.
Rückgabewert
Ein Handle für die Schriftart, die für die aktuelle Zelle verwendet wird.
Hinweise
Diese Methode gibt standardmäßig zurück NULL. Alle Zellen in einem Listensteuerelement haben dieselbe Schriftart. Überschreiben Sie diese Methode, um unterschiedliche Schriftarten für unterschiedliche Zellen bereitzustellen.
CMFCListCtrl::OnGetCellTextColor
Das Framework ruft diese Methode auf, wenn sie die Textfarbe einer einzelnen Zelle bestimmen muss.
virtual COLORREF OnGetCellTextColor(
int nRow,
int nColumn);
Parameter
nRow
[in] Die Zeile der betreffenden Zelle.
nColumn
[in] Die Spalte der betreffenden Zelle.
Rückgabewert
Ein COLOREF Wert, der die Textfarbe der Zelle angibt.
Hinweise
Diese Methode ruft standardmäßig unabhängig von Eingabeparametern auf GetTextColor . Das gesamte Listensteuerelement hat dieselbe Textfarbe. Sie können in einer abgeleiteten Klasse außer Kraft setzen OnGetCellTextColor , um einzelne Zellen mit einer separaten Textfarbe zu markieren.
CMFCListCtrl::RemoveSortColumn
Entfernt eine Sortierspalte aus der Liste sortierter Spalten.
void RemoveSortColumn(int iColumn);
Parameter
iColumn
[in] Die zu entfernende Spalte.
Hinweise
Mit dieser Methode wird eine Sortierspalte aus dem Kopfzeilensteuerelement entfernt. Es wird aufgerufen CMFCHeaderCtrl::RemoveSortColumn.
CMFCListCtrl::SetSortColumn
Legt die aktuelle sortierte Spalte und die Sortierreihenfolge fest.
void SetSortColumn(
int iColumn,
BOOL bAscending = TRUE,
BOOL bAdd = FALSE);
Parameter
iColumn
[in] Die spalte, die sortiert werden soll.
bAscending
[in] Ein Boolescher Wert, der die Sortierreihenfolge angibt.
bAdd
[in] Ein Boolescher Wert, der angibt, ob die Methode die Spalte hinzufügt, die in iColumn der Liste der Sortierspalten angegeben ist.
Hinweise
Diese Methode übergibt die Eingabeparameter mithilfe der Methode CMFCHeaderCtrl::SetSortColumnan das Headersteuerelement.
CMFCListCtrl::Sort
Sortiert das Listensteuerelement.
virtual void Sort(
int iColumn,
BOOL bAscending = TRUE,
BOOL bAdd = FALSE);
Parameter
iColumn
[in] Die spalte, die sortiert werden soll.
bAscending
[in] Ein Boolescher Wert, der die Sortierreihenfolge angibt.
bAdd
[in] Ein Boolescher Wert, der angibt, ob diese Methode die Spalte hinzufügt, die der iColumn Liste der Sortierspalten angezeigt wird.
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für