Compartilhar via


DataGridViewColumn.DisplayIndex Propriedade

Definição

Obtém ou define a ordem de exibição da coluna em relação às colunas exibidas no momento.

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

Exceções

DataGridView não é null e o valor especificado quando a configuração dessa propriedade é menor que 0 ou maior ou igual ao número de colunas no controle.

- ou -

DataGridView é null e o valor especificado ao definir essa propriedade é menor que -1.

- ou -

O valor especificado ao definir essa propriedade é igual a Int32.MaxValue.

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