Condividi tramite

DataGridViewColumn.DisplayIndex Proprietà

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Origine:
DataGridViewColumn.cs
Origine:
DataGridViewColumn.cs
Origine:
DataGridViewColumn.cs
Origine:
DataGridViewColumn.cs
Origine:
DataGridViewColumn.cs

Ottiene o imposta l'ordine di visualizzazione della colonna rispetto 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 visualizzata nell'oggetto associato DataGridViewo -1 se la banda non è contenuta all'interno di un controllo .

Attributi
BrowsableAttribute

Eccezioni

ArgumentOutOfRangeException

DataGridView non null è e il valore specificato quando si imposta questa proprietà è minore di 0 o maggiore o uguale al numero di colonne nel controllo .

oppure

DataGridView è null e il valore specificato quando si imposta questa 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 valore della Visible 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 nel controllo ha un valore univoco DisplayIndex . I valori iniziano con 0 e procedono 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

Vedi anche