Partilhar via


DataGridViewColumnCollection.GetFirstColumn Método

Definição

Retorna a primeira coluna na ordem de exibição que atende aos requisitos de filtro fornecidos.

Sobrecargas

GetFirstColumn(DataGridViewElementStates)

Retorna a primeira coluna na ordem de exibição que atende aos requisitos de filtro de inclusão fornecidos.

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Retorna a primeira coluna na ordem de exibição que atende aos requisitos de filtro de inclusão e exclusão fornecidos.

GetFirstColumn(DataGridViewElementStates)

Retorna a primeira coluna na ordem de exibição que atende aos requisitos de filtro de inclusão fornecidos.

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 valores DataGridViewElementStates que representa o filtro para inclusão.

Retornos

DataGridViewColumn

A primeira coluna na ordem de exibição que atende aos requisitos de filtro fornecidos ou null se nenhuma coluna foi encontrada.

Exceções

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

Exemplos

O exemplo de código a seguir usa o GetFirstColumn método para trocar a primeira coluna exibida e a última coluna exibida.

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

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

Esse método permite determinar a primeira coluna que se ajusta aos critérios especificados sem precisar comparar valores de índice diretamente.

Confira também

Aplica-se a

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Retorna a primeira coluna na ordem de exibição que atende aos requisitos de filtro de inclusão e exclusão fornecidos.

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 valores DataGridViewElementStates que representam o filtro para aplicar inclusão.

excludeFilter
DataGridViewElementStates

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

Retornos

DataGridViewColumn

A primeira coluna na ordem de exibição que atende aos requisitos de filtro fornecidos ou null se nenhuma coluna foi encontrada.

Exceções

Pelo menos um dos valores de filtro não é uma combinação bit a bit válida de valores DataGridViewElementStates.

Comentários

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

Esse método permite determinar a primeira coluna que se ajusta aos critérios especificados sem precisar comparar valores de índice diretamente.

Confira também

Aplica-se a