Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
DataGridViewColumn.DisplayIndex-Eigenschaft
Ruft die Anzeigereihenfolge der Spalte relativ zu den derzeit angezeigten Spalten ab oder legt sie fest.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Eigenschaftswert
Typ: System.Int32Die nullbasierte Position der Spalte, wie sie in der zugeordneten DataGridView angezeigt wird, oder -1, wenn das Band nicht in einem Steuerelement enthalten ist.
| Ausnahme | Bedingung |
|---|---|
| ArgumentOutOfRangeException |
DataGridViewElement.DataGridView ist nicht null, und der angegebene Wert ist beim Festlegen dieser Eigenschaft ist kleiner als 0 (null) bzw. größer oder gleich der Anzahl von Spalten im Steuerelement. – oder – DataGridViewElement.DataGridView ist null, und der beim Festlegen dieser Eigenschaft angegebene Wert ist kleiner als -1. – oder – Der beim Festlegen dieser Eigenschaft angegebene Wert ist gleich Int32.MaxValue. |
Im Gegensatz zur Index-Eigenschaft entspricht die DisplayIndex-Eigenschaft der aktuellen Position der Spalte, wie sie von der Benutzeroberfläche angezeigt wird. Standardmäßig ist der DisplayIndex jeder Spalte auf Zahlen in aufsteigender Reihenfolge festgelegt. Dies stellt die Reihenfolge dar, in der sie hinzugefügt wurden. Der Wert der Visible-Eigenschaft beeinflusst den DisplayIndex-Wert nicht. Ermitteln Sie die Anzeigeposition einer Spalte anhand ihrer Sichtbarkeit oder eines anderen Zustands mithilfe der Methoden GetFirstColumn, GetLastColumn oder GetNextColumn der DataGridViewColumnCollection-Klasse.
Jede Spalte im Steuerelement verfügt über einen eindeutigen DisplayIndex-Wert. Die Werte beginnen mit 0 und gehen in numerischer Reihenfolge weiter. Es werden keine Werte übersprungen. Wenn Sie den DisplayIndex-Wert für eine Spalte ändern, werden die DisplayIndex-Werte für andere Spalten so geändert, dass sie die neue Reihenfolge darstellen.
Wenn die Spalte über ein zugeordnetes DataGridView-Steuerelement verfügt, zeichnet sich das Steuerelement nach dem Festlegen dieser Eigenschaft selbst neu.
Im folgenden Codebeispiel wird mithilfe der DisplayIndex-Eigenschaft die sichtbare Position der ersten und der letzten Spalte ausgetauscht. Beachten Sie, dass Einfügevorgänge vor DisplayIndex erfolgen. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die DataGridViewColumn-Klasse.
// Swap the last column with the first. private void Button10_Click(object sender, EventArgs args) { DataGridViewColumnCollection columnCollection = dataGridView.Columns; DataGridViewColumn firstVisibleColumn = columnCollection.GetFirstColumn(DataGridViewElementStates.Visible); DataGridViewColumn lastVisibleColumn = columnCollection.GetLastColumn( DataGridViewElementStates.Visible, DataGridViewElementStates.None); int firstColumn_sIndex = firstVisibleColumn.DisplayIndex; firstVisibleColumn.DisplayIndex = lastVisibleColumn.DisplayIndex; lastVisibleColumn.DisplayIndex = firstColumn_sIndex; }
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
