DataGridViewColumn.DisplayIndex Propriedade

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

Valor da propriedade

A posição de base zero da coluna como exibida no DataGridView associado, ou -1, se a banda não estiver contida em um controle.

Atributos

BrowsableAttribute

Exceções

Exemplos

O exemplo de código a seguir usa a DisplayIndex propriedade para trocar a posição visual da primeira e da última coluna. Observe que as inserções ocorrem antes do DisplayIndex. Este exemplo de código faz parte de um exemplo maior fornecido para a 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

Comentários

Ao contrário da Index propriedade , a DisplayIndex propriedade corresponde à posição atual da coluna, conforme exibido pela interface do usuário. Por padrão, cada coluna DisplayIndex é definida como número de ordem crescente, o que reflete a ordem em que foram adicionadas. O Visible valor da propriedade não afeta o DisplayIndex valor. Para determinar a posição de exibição de uma coluna com base em sua visibilidade ou outro estado, use o GetFirstColumnmétodo , GetLastColumnou GetNextColumn da DataGridViewColumnCollection classe .

Cada coluna no controle tem um valor exclusivo DisplayIndex . Os valores começam com 0 e prossseguem em ordem numérica sem ignorar nenhum valor. Quando você altera o DisplayIndex valor de uma coluna, os DisplayIndex valores de outras colunas são alterados para refletir a nova ordem.

Se a coluna tiver um controle associado DataGridView , definir essa propriedade fará com que o controle seja redesenhado.

Aplica-se a

Confira também

• DataGridView
• Index
• GetFirstColumn
• GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)
• GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)
• DataGridViewColumnCollection