DataGridViewColumn.DisplayIndex Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Anzeigereihenfolge der Spalte relativ zu den aktuell angezeigten Spalten ab oder legt sie fest.
public:
property int DisplayIndex { int get(); void set(int value); };[System.ComponentModel.Browsable(false)]
public int DisplayIndex { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.DisplayIndex : int with get, setPublic Property DisplayIndex As IntegerEigenschaftswert
Die nullbasierte Position der Spalte, wie sie im zugeordneten DataGridViewElement angezeigt wird, oder -1, wenn das Band nicht in einem Steuerelement enthalten ist.
- Attribute
Ausnahmen
DataGridView ist nicht null und der angegebene Wert beim Festlegen dieser Eigenschaft kleiner als 0 oder größer als oder gleich der Anzahl der Spalten im Steuerelement.
- oder -
DataGridView ist null und der angegebene Wert beim Festlegen dieser Eigenschaft kleiner als -1 ist.
- oder -
Der angegebene Wert beim Festlegen dieser Eigenschaft ist gleich Int32.MaxValue.
Beispiele
Im folgenden Codebeispiel wird die DisplayIndex Eigenschaft verwendet, um die visuelle Position der ersten und letzten Spalten zu tauschen. Beachten Sie, dass Einfügungen vor dem DisplayIndex. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataGridViewColumn Klasse bereitgestellt wird.
// Swap the last column with the first.
void Button10_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
DataGridViewColumnCollection^ columnCollection = dataGridView->Columns;
DataGridViewColumn^ firstDisplayedColumn = columnCollection->GetFirstColumn( DataGridViewElementStates::Visible );
DataGridViewColumn^ lastDisplayedColumn = columnCollection->GetLastColumn( DataGridViewElementStates::Visible, DataGridViewElementStates::None );
int firstColumn_sIndex = firstDisplayedColumn->DisplayIndex;
firstDisplayedColumn->DisplayIndex = lastDisplayedColumn->DisplayIndex;
lastDisplayedColumn->DisplayIndex = firstColumn_sIndex;
}
// 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;
}
' Swap the last column with the first.
Private Sub Button10_Click(ByVal sender As Object, _
ByVal args As EventArgs) Handles Button10.Click
Dim columnCollection As DataGridViewColumnCollection = _
dataGridView.Columns
Dim firstVisibleColumn As DataGridViewColumn = _
columnCollection.GetFirstColumn(DataGridViewElementStates.Visible)
Dim lastVisibleColumn As DataGridViewColumn = _
columnCollection.GetLastColumn(DataGridViewElementStates.Visible, _
Nothing)
Dim firstColumn_sIndex As Integer = firstVisibleColumn.DisplayIndex
firstVisibleColumn.DisplayIndex = _
lastVisibleColumn.DisplayIndex
lastVisibleColumn.DisplayIndex = firstColumn_sIndex
End Sub
Hinweise
Index Im Gegensatz zur Eigenschaft entspricht die DisplayIndex Eigenschaft der aktuellen Position der Spalte, wie sie von der Benutzeroberfläche (UI) angezeigt wird. Standardmäßig wird jede Spalte DisplayIndex auf Zahlen erhöhter Reihenfolge festgelegt, die die Reihenfolge widerspiegelt, in der sie hinzugefügt wurden. Der Visible Eigenschaftswert wirkt sich nicht auf den DisplayIndex Wert aus. Um die Anzeigeposition einer Spalte basierend auf ihrer Sichtbarkeit oder einem anderen Zustand zu bestimmen, verwenden Sie die GetFirstColumn, GetLastColumnoder GetNextColumn Methode der DataGridViewColumnCollection Klasse.
Jede Spalte im Steuerelement weist einen eindeutigen DisplayIndex Wert auf. Die Werte beginnen mit 0 und fahren in numerischer Reihenfolge fort, ohne werte zu überspringen. Wenn Sie den DisplayIndex Wert für eine Spalte ändern, werden die DisplayIndex Werte für andere Spalten geändert, um die neue Reihenfolge widerzuspiegeln.
Wenn die Spalte über ein zugeordnetes DataGridView Steuerelement verfügt, bewirkt das Festlegen dieser Eigenschaft, dass das Steuerelement selbst neu gezeichnet wird.
