DataGridViewColumn.DisplayIndex Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta l'ordine di visualizzazione della colonna relativa alle colonne attualmente visualizzate.

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

Valore della proprietà

Int32

Posizione in base zero della colonna così come viene visualizzata nella classe DataGridView oppure -1 se la banda non è contenuta nel controllo.

Attributi: BrowsableAttribute

Eccezioni

ArgumentOutOfRangeException

La proprietà DataGridView non è null e il valore specificato al momento dell'impostazione di questa proprietà è minore di 0 oppure maggiore o uguale al numero di colonne nel controllo.

-oppure-

La proprietà DataGridView è null e il valore specificato al momento dell'impostazione della proprietà è minore di -1.

-oppure-

Il valore specificato quando si imposta questa proprietà è uguale a Int32.MaxValue.

Esempio

Nell'esempio di codice seguente viene utilizzata la DisplayIndex proprietà per scambiare la posizione visiva della prima e dell'ultima colonna. Si noti che gli inserimenti si verificano prima di DisplayIndex. Questo esempio di codice fa parte di un esempio più ampio fornito per la DataGridViewColumn classe .

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

Commenti

A differenza della Index proprietà , la DisplayIndex proprietà corrisponde alla posizione corrente della colonna visualizzata dall'interfaccia utente. Per impostazione predefinita, ogni colonna DisplayIndex è impostata su numeri di ordine crescente, che riflette l'ordine in cui sono stati aggiunti. Il Visible valore della proprietà non influisce sul DisplayIndex valore. Per determinare la posizione di visualizzazione di una colonna in base alla visibilità o ad altro stato, utilizzare il GetFirstColumnmetodo , GetLastColumno GetNextColumn della DataGridViewColumnCollection classe .

Ogni colonna del controllo ha un valore univoco DisplayIndex . I valori iniziano con 0 e proseguono in ordine numerico senza ignorare alcun valore. Quando si modifica il DisplayIndex valore di una colonna, i DisplayIndex valori per altre colonne vengono modificati in modo da riflettere il nuovo ordine.

Se la colonna dispone di un controllo associato DataGridView , impostando questa proprietà, il controllo verrà ridisegnato.

Si applica a