Freigeben über

DataGrid-Elemente

Das DataGrid Steuerelement besteht aus mehreren spezialisierten Komponententypen, die zusammen zum Anzeigen und Verwalten von Tabellendaten zusammenarbeiten. Das Verständnis dieser Komponenten und ihre Beziehung zu DataGrid hilft Ihnen, das Aussehen und Verhalten des Datenrasters an Ihre spezifischen Anforderungen anzupassen.

Elementübersicht

Dies DataGrid besteht aus den folgenden primären Elementen:

  • DataGridCell - Stellt eine einzelne Zelle innerhalb des Rasters dar, die einen einzelnen Datenwert anzeigt.
  • DataGridRow - Stellt eine Datenzeile innerhalb des Rasters dar, die mehrere Zellen enthält.
  • DataGridRowHeader – Stellt den Zeilenkopfbereich auf der linken Seite jeder Zeile bereit, der in der Regel für die Zeilenauswahlanzeigen verwendet wird.
  • DataGridColumnHeader - Stellt die Kopfzeile einer Spalte dar, die normalerweise den Spaltentitel anzeigt und Sortierfunktionen bereitstellt.
  • DataGridColumnHeadersPresenter - Enthält und zeigt alle Spaltenüberschriften in einer Zeile am oberen Rand des Rasters an.

Diese Elemente werden innerhalb von DataGrid hierarchisch angeordnet, um das vertraute tabellarische Layout zu erstellen. Jede DataGridRow enthält mehrere DataGridCell Elemente zusammen mit einem DataGridRowHeader, während die DataGridColumnHeadersPresenter Spaltenüberschriften oben angezeigt werden.

Anpassen von Elementen

Sie können jedes Element anpassen, indem Sie Formatvorlagen anwenden oder Vorlagen ändern. Beispiel:

Weitere Informationen zum Formatieren und Vorlagen finden Sie unter "Formatieren und Vorlagen".

DataGridCell

Das DataGridCell Element stellt eine einzelne Zelle im Datenraster dar und reagiert auf Benutzerinteraktionen wie Auswahl und Bearbeitung.

Bestandteile

Das DataGridCell Element definiert keine benannten Vorlagenteile.

Zustände

In der folgenden Tabelle sind die visuellen Zustände für das DataGridCell Element aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
Normal CommonStates Der Standardstatus.
Mauszeiger CommonStates Der Mauszeiger wird über der Zelle positioniert.
Focused FocusStates Die Zelle hat den Fokus.
Unfokussiert FocusStates Die Zelle hat keinen Fokus.
Current AktuelleZustände Die Zelle ist die aktuelle Zelle.
Regulär Aktuelle Zustände Die Zelle ist nicht die aktuelle Zelle.
Display InteractionStates Die Zelle befindet sich im Anzeigemodus.
Bearbeiten InteractionStates Die Zelle befindet sich im Bearbeitungsmodus.
Ausgewählt SelectionStates Die Zelle ist ausgewählt.
Nicht ausgewählt SelectionStates Die Zelle ist nicht ausgewählt.
UngültigerFokusiert Validierungszustände Die Zelle ist ungültig und hat den Fokus.
InvalidNichtFokussiert Validierungszustände Die Zelle ist ungültig und hat keinen Fokus.
Gültig Validierungszustände Die Zelle ist gültig.

DataGridRow

Das DataGridRow Element stellt eine Datenzeile innerhalb des Rasters dar. Jede Zeile enthält mehrere Zellen und eine Zeilenüberschrift.

Bestandteile

Das DataGridRow Element definiert keine benannten Vorlagenteile.

Zustände

In der folgenden Tabelle sind die visuellen Zustände für das DataGridRow Element aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
Normal CommonStates Der Standardstatus.
Mauszeiger CommonStates Der Mauszeiger befindet sich über der Zeile.
MouseOver-Bearbeitung CommonStates Der Mauszeiger wird über der Zeile positioniert, und die Zeile befindet sich im Bearbeitungsmodus.
MouseOver_Ausgewählt CommonStates Der Mauszeiger wird über der Zeile positioniert, und die Zeile wird ausgewählt.
MausÜber_Unfokussiertes_Bearbeiten CommonStates Der Mauszeiger befindet sich über der Zeile, die Zeile befindet sich im Bearbeitungsmodus und hat keinen Fokus.
MouseOver_Unfocused_Selected CommonStates Der Mauszeiger wird über der Zeile positioniert, die Zeile ist ausgewählt und hat keinen Fokus.
Normal_AlternierendeReihe CommonStates Die Zeile ist eine wechselnde Zeile.
Normal_Editing CommonStates Die Zeile befindet sich im Bearbeitungsmodus.
Normal_Ausgewählt CommonStates Die Zeile ist ausgewählt.
Unfokussiertes_Bearbeiten CommonStates Die Zeile befindet sich im Bearbeitungsmodus und hat keinen Fokus.
Nicht fokussiert_Ausgewählt CommonStates Die Zeile ist ausgewählt und hat keinen Fokus.
UngültigerFokusiert Validierungszustände Das Steuerelement ist ungültig und hat den Fokus.
InvalidNichtFokussiert Validierungszustände Das Steuerelement ist ungültig und hat keinen Fokus.
Gültig Validierungszustände Die Kontrolle ist gültig.

DataGridRowHeader

Das DataGridRowHeader Element wird auf der linken Seite jeder Zeile angezeigt und zeigt in der Regel Zeilenauswahlindikatoren oder Zeilennummern an.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das DataGridRowHeader Element aufgeführt.

Teil Typ Description
PART_TopHeaderGripper Thumb Das Element, das zum Ändern der Größe der Zeilenüberschrift vom oberen Rand verwendet wird.
PART_BottomHeaderGripper Thumb Das Element, das verwendet wird, um die Größe der Zeilenüberschrift von unten zu ändern.

Zustände

In der folgenden Tabelle sind die visuellen Zustände für das DataGridRowHeader Element aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
Normal CommonStates Der Standardstatus.
Mauszeiger CommonStates Der Mauszeiger befindet sich über der Zeile.
MouseOver_AktuelleZeile CommonStates Der Mauszeiger wird über der Zeile positioniert, und die Zeile ist die aktuelle Zeile.
MausÜber_AktuelleZeile_Ausgewählt CommonStates Der Mauszeiger wird über der Zeile positioniert, und die Zeile ist aktuell und ausgewählt.
MouseOver_EditingRow CommonStates Der Mauszeiger wird über der Zeile positioniert, und die Zeile befindet sich im Bearbeitungsmodus.
MouseOver_Ausgewählt CommonStates Der Mauszeiger wird über der Zeile positioniert, und die Zeile wird ausgewählt.
MouseOver_Unfokussiert_AktuelleZeile_Ausgewählt CommonStates Der Mauszeiger wird über der Zeile positioniert, die Zeile ist aktuell und ausgewählt und hat keinen Fokus.
MausÜber_Unfokussiert_Bearbeitungszeile CommonStates Der Mauszeiger befindet sich über der Zeile, die Zeile befindet sich im Bearbeitungsmodus und hat keinen Fokus.
MouseOver_Unfocused_Selected CommonStates Der Mauszeiger wird über der Zeile positioniert, die Zeile ist ausgewählt und hat keinen Fokus.
Normal_AktuelleZeile CommonStates Die Zeile ist die aktuelle Zeile.
Normal_AktuelleZeile_Ausgewählt CommonStates Die Zeile ist die aktuelle Zeile und ist ausgewählt.
Normal_EditingRow CommonStates Die Zeile befindet sich im Bearbeitungsmodus.
Normal_Ausgewählt CommonStates Die Zeile ist ausgewählt.
Unfokussiert_AktuelleZeile_Ausgewählt CommonStates Die Zeile ist die aktuelle Zeile, ist ausgewählt und hat keinen Fokus.
Nicht fokussierte Bearbeitungszeile CommonStates Die Zeile befindet sich im Bearbeitungsmodus und hat keinen Fokus.
Nicht fokussiert_Ausgewählt CommonStates Die Zeile ist ausgewählt und hat keinen Fokus.
UngültigerFokusiert Validierungszustände Das Steuerelement ist ungültig und hat den Fokus.
InvalidNichtFokussiert Validierungszustände Das Steuerelement ist ungültig und hat keinen Fokus.
Gültig Validierungszustände Das Steuerungselement ist gültig.

DataGridColumnHeadersPresenter

Das DataGridColumnHeadersPresenter Element enthält alle Spaltenüberschriften und zeigt sie in einer Zeile am oberen Rand des Datenrasters an.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das DataGridColumnHeadersPresenter Element aufgeführt.

Teil Typ Description
PART_Füllspaltenüberschrift DataGridColumnHeader Der Platzhalter für Spaltenüberschriften.

Zustände

In der folgenden Tabelle sind die visuellen Zustände für das DataGridColumnHeadersPresenter Element aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
UngültigerFokusiert Validierungszustände Die Zelle ist ungültig und hat den Fokus.
InvalidNichtFokussiert Validierungszustände Die Zelle ist ungültig und hat keinen Fokus.
Gültig Validierungszustände Die Zelle ist gültig.

DataGridColumnHeader

Das DataGridColumnHeader Element stellt die Kopfzeile einer Spalte dar. Spaltenüberschriften zeigen in der Regel den Spaltentitel an und stellen Sortierfunktionen bereit, wenn sie geklickt werden.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das DataGridColumnHeader Element aufgeführt.

Teil Typ Description
PART_LeftHeaderGripper Thumb Das Element, das zum Ändern der Größe der Spaltenüberschrift von links verwendet wird.
PART_RightHeaderGripper Thumb Das Element, das zum Ändern der Größe der Spaltenüberschrift von rechts verwendet wird.

Zustände

In der folgenden Tabelle sind die visuellen Zustände für das DataGridColumnHeader Element aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
Normal CommonStates Der Standardstatus.
Mauszeiger CommonStates Der Mauszeiger wird über dem Steuerelement positioniert.
Gedrückt CommonStates Das Steuerelement wird gedrückt.
SortAscending SortStates Die Spalte wird in aufsteigender Reihenfolge sortiert.
SortDescending SortStates Die Spalte wird in absteigender Reihenfolge sortiert.
Unsortiert SortStates Die Spalte ist nicht sortiert.
UngültigerFokusiert Validierungszustände Das Steuerelement ist ungültig und hat den Fokus.
InvalidNichtFokussiert Validierungszustände Das Steuerelement ist ungültig und hat keinen Fokus.
Gültig Validierungszustände Die Kontrolle ist gültig.

Siehe auch

  • Last updated on