DataGridViewColumn.DisplayIndex Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 derzeit 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, set

Public Property DisplayIndex As Integer

Eigenschaftswert

Int32

Die nullbasierte Position der Spalte, wie sie in der zugeordneten DataGridView angezeigt wird, oder -1, wenn das Band nicht in einem Steuerelement enthalten ist.

Attribute: BrowsableAttribute

Ausnahmen

ArgumentOutOfRangeException

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 -

DataGridView ist null, und der beim Festlegen dieser Eigenschaft angegebene Wert ist kleiner als -1.

- 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 Spalte zu tauschen. Beachten Sie, dass Einfügungen vor dem DisplayIndexauftreten. 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, die von der Benutzeroberfläche (UI) angezeigt wird. Standardmäßig ist jede DisplayIndex Spalte auf Zahlen mit steigender Reihenfolge festgelegt, was die Reihenfolge widerspiegelt, in der sie hinzugefügt wurden. Der Visible Eigenschaftswert wirkt sich nicht auf den DisplayIndex Wert aus. Verwenden Sie die - oder -Methode der -Klasse, um die GetFirstColumn GetLastColumn GetNextColumn Anzeigeposition einer Spalte basierend auf ihrer Sichtbarkeit oder einem anderen Zustand zu DataGridViewColumnCollection bestimmen.

Jede Spalte im Steuerelement verfügt über einen eindeutigen DisplayIndex Wert. Die Werte beginnen mit 0 und werden in numerischer Reihenfolge fortgesetzt, 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 der Spalte ein Steuerelement zugeordnet DataGridView ist, führt das Festlegen dieser Eigenschaft dazu, dass sich das Steuerelement selbst neu zeichnet.

Gilt für: