DataGridViewColumn.DisplayIndex Propriedade

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

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

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 de Propriedade

Int32

A posição base zero da coluna tal como é exibida no , ou DataGridView-1 se a banda não estiver contida num controlo.

Atributos
BrowsableAttribute

Exceções

ArgumentOutOfRangeException

DataGridView não null é e o valor especificado ao definir esta propriedade é menor que 0 ou maior ou igual ao número de colunas no controlo.

-ou-

DataGridView é null e o valor especificado ao definir esta propriedade é inferior a -1.

-ou-

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

Exemplos

O exemplo de código seguinte usa a DisplayIndex propriedade para trocar a posição visual da primeira e da última colunas. Note-se 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

Observações

Ao contrário da Index propriedade, esta DisplayIndex corresponde à posição atual da coluna conforme apresentada pela interface do utilizador (UI). Por defeito, a de cada coluna DisplayIndex é definida para números de ordem crescente, o que reflete a ordem em que foram adicionadas. O valor da Visible propriedade não afeta o DisplayIndex valor. Para determinar a posição de exibição de uma coluna com base na sua visibilidade ou outro estado, use o GetFirstColumn, GetLastColumn, ou GetNextColumn método da DataGridViewColumnCollection classe.

Cada coluna no controlo tem um valor único DisplayIndex . Os valores começam com 0 e prosseguem por ordem numérica sem omitir nenhum valor. Quando mudas o DisplayIndex valor de uma coluna, os DisplayIndex valores das outras colunas são alterados para refletir a nova ordem.

Se a coluna tiver um controlo associado DataGridView , definir essa propriedade fará com que o controlo se volte a desenhar.

Aplica-se a

Ver também