DataGridViewColumnCollection.GetFirstColumn Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

ArgumentException

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

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates

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

ArgumentException

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

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates