DataGridViewColumnCollection.GetFirstColumn Método

Definição

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

Assemblagem:: System.Windows.Forms.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Devolve a primeira coluna por ordem de exibição que cumpre os requisitos dados do filtro.

Sobrecargas

Name	Description
GetFirstColumn(DataGridViewElementStates)	Devolve a primeira coluna por ordem de exibição que cumpre os requisitos dados do filtro de inclusão.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Devolve a primeira coluna por ordem de exibição que cumpre os requisitos dados de filtro de inclusão e filtro de exclusão.

GetFirstColumn(DataGridViewElementStates)

Devolve a primeira coluna por ordem de exibição que cumpre os requisitos dados do filtro de inclusão.

public:
 System::Windows::Forms::DataGridViewColumn ^ GetFirstColumn(System::Windows::Forms::DataGridViewElementStates includeFilter);

public System.Windows.Forms.DataGridViewColumn GetFirstColumn(System.Windows.Forms.DataGridViewElementStates includeFilter);

member this.GetFirstColumn : System.Windows.Forms.DataGridViewElementStates -> System.Windows.Forms.DataGridViewColumn

Public Function GetFirstColumn (includeFilter As DataGridViewElementStates) As DataGridViewColumn

Parâmetros

includeFilter: DataGridViewElementStates

Uma combinação bit a bit dos DataGridViewElementStates valores que representa o filtro para inclusão.

Devoluções

DataGridViewColumn

A primeira coluna na ordem de exibição que cumpra os requisitos de filtro dados, ou null se não for encontrada nenhuma coluna.

Exceções

ArgumentException

includeFilter não é uma combinação válida de DataGridViewElementStates valores bit a bit.

Exemplos

O exemplo de código seguinte utiliza o GetFirstColumn método para trocar a primeira coluna apresentada pela última coluna apresentada.

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

A primeira coluna na ordem de exibição é a coluna com o valor mais baixo DisplayIndex , independentemente de a coluna ser realmente visível no ecrã.

Este método permite-lhe determinar a primeira coluna que se enquadra nos critérios dados sem ter de comparar diretamente os valores dos índices.

Ver também

Aplica-se a

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Devolve a primeira coluna por ordem de exibição que cumpre os requisitos dados de filtro de inclusão e filtro de exclusão.

public:
 System::Windows::Forms::DataGridViewColumn ^ GetFirstColumn(System::Windows::Forms::DataGridViewElementStates includeFilter, System::Windows::Forms::DataGridViewElementStates excludeFilter);

public System.Windows.Forms.DataGridViewColumn GetFirstColumn(System.Windows.Forms.DataGridViewElementStates includeFilter, System.Windows.Forms.DataGridViewElementStates excludeFilter);

member this.GetFirstColumn : System.Windows.Forms.DataGridViewElementStates * System.Windows.Forms.DataGridViewElementStates -> System.Windows.Forms.DataGridViewColumn

Public Function GetFirstColumn (includeFilter As DataGridViewElementStates, excludeFilter As DataGridViewElementStates) As DataGridViewColumn

Parâmetros

includeFilter: DataGridViewElementStates

Uma combinação bit a bit dos DataGridViewElementStates valores que representam o filtro a aplicar para inclusão.

excludeFilter: DataGridViewElementStates

Uma combinação bit a bit dos DataGridViewElementStates valores que representam o filtro a aplicar para exclusão.