DataGridViewColumn.DisplayIndex Eigenschaft

Definition

Ruft die Anzeigereihenfolge der Spalte relativ zu den derzeit angezeigten Spalten ab oder legt sie fest.Gets or sets the display order of the column relative to the currently displayed columns.

public:
 property int DisplayIndex { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
public int DisplayIndex { get; set; }
member this.DisplayIndex : int with get, set
Public Property DisplayIndex As Integer

Eigenschaftswert

Die nullbasierte Position der Spalte, wie sie in der zugeordneten DataGridView angezeigt wird, oder -1, wenn das Band nicht in einem Steuerelement enthalten ist.The zero-based position of the column as it is displayed in the associated DataGridView, or -1 if the band is not contained within a control.

Attribute

Ausnahmen

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.DataGridView is not null and the specified value when setting this property is less than 0 or greater than or equal to the number of columns in the control.

- oder --or- DataGridView ist null, und der beim Festlegen dieser Eigenschaft angegebene Wert ist kleiner als -1.DataGridView is null and the specified value when setting this property is less than -1.

- oder --or- Der beim Festlegen dieser Eigenschaft angegebene Wert ist gleich MaxValue.The specified value when setting this property is equal to MaxValue.

Beispiele

Im folgenden Codebeispiel wird die DisplayIndex-Eigenschaft verwendet, um die visuelle Position der ersten und letzten Spalte auszutauschen.The following code example uses the DisplayIndex property to swap the visual position of the first and last columns. Beachten Sie, dass Einfügungen vor dem DisplayIndexerfolgen.Note that insertions occur before the DisplayIndex. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataGridViewColumn-Klasse bereitgestellt wird.This code example is part of a larger example provided for the DataGridViewColumn class.

// 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

Im Gegensatz zur Index-Eigenschaft entspricht die DisplayIndex-Eigenschaft der aktuellen Position der Spalte, wie Sie von der Benutzeroberfläche (UI) angezeigt wird.Unlike the Index property, the DisplayIndex property corresponds to the current position of the column as displayed by the user interface (UI). Standardmäßig wird die DisplayIndex der Spalte auf Zahlen in aufsteigender Reihenfolge festgelegt, die die Reihenfolge widerspiegelt, in der Sie hinzugefügt wurden.By default, each column's DisplayIndex is set to numbers of increasing order, which reflects the order in which they were added. Der Wert der Visible-Eigenschaft wirkt sich nicht auf den DisplayIndex Wert aus.The Visible property value does not affect the DisplayIndex value. Um die Anzeigeposition einer Spalte auf Grundlage ihrer Sichtbarkeit oder eines anderen Zustands zu bestimmen, verwenden Sie die GetFirstColumn-, GetLastColumn-oder GetNextColumn-Methode der DataGridViewColumnCollection-Klasse.To determine the display position of a column based on its visibility or other state, use the GetFirstColumn, GetLastColumn, or GetNextColumn method of the DataGridViewColumnCollection class.

Jede Spalte im-Steuerelement verfügt über einen eindeutigen DisplayIndex Wert.Every column in the control has a unique DisplayIndex value. Die Werte beginnen mit 0 und werden in numerischer Reihenfolge fortgesetzt, ohne dass Werte übersprungen werden.The values start with 0 and proceed in numerical order without skipping any values. 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 widerspiegeln.When you change the DisplayIndex value for a column, the DisplayIndex values for other columns are changed to reflect the new order.

Wenn der Spalte DataGridView-Steuerelement zugeordnet ist, wird durch das Festlegen dieser Eigenschaft das Steuerelement neu gezeichnet.If the column has an associated DataGridView control, setting this property will cause the control to redraw itself.

Gilt für:

Siehe auch