DataGridViewColumnCollection.GetFirstColumn Método

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Devuelve la primera columna en orden de presentación que cumple los requisitos de filtro especificados.

Sobrecargas

Nombre	Description
GetFirstColumn(DataGridViewElementStates)	Devuelve la primera columna en orden de presentación que cumple los requisitos de filtro de inclusión especificados.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Devuelve la primera columna en orden de presentación que cumple los requisitos especificados de filtro de inclusión y filtro de exclusión.

GetFirstColumn(DataGridViewElementStates)

Devuelve la primera columna en orden de presentación que cumple los requisitos de filtro de inclusión especificados.

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

Combinación bit a bit de los DataGridViewElementStates valores que representa el filtro para su inclusión.

Devoluciones

DataGridViewColumn

Primera columna en orden de presentación que cumple los requisitos de filtro especificados o null si no se encuentra ninguna columna.

Excepciones

ArgumentException

includeFilter no es una combinación bit a bit válida de DataGridViewElementStates valores.

Ejemplos

En el ejemplo de código siguiente se usa el GetFirstColumn método para intercambiar la primera columna mostrada y la última columna mostrada.

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

Comentarios

La primera columna en orden de presentación es la columna con el valor más bajo DisplayIndex , independientemente de si la columna está realmente visible en la pantalla.

Este método permite determinar la primera columna que se ajusta a los criterios especificados sin tener que comparar los valores de índice directamente.

Consulte también

Se aplica a

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Devuelve la primera columna en orden de presentación que cumple los requisitos especificados de filtro de inclusión y filtro de exclusión.

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

Combinación bit a bit de los DataGridViewElementStates valores que representan el filtro que se va a aplicar para su inclusión.

excludeFilter: DataGridViewElementStates

Combinación bit a bit de los DataGridViewElementStates valores que representan el filtro que se va a aplicar para la exclusión.

Devoluciones

DataGridViewColumn

Primera columna en orden de presentación que cumple los requisitos de filtro especificados o null si no se encuentra ninguna columna.

Excepciones

ArgumentException

Al menos uno de los valores de filtro no es una combinación bit a bit válida de DataGridViewElementStates valores.

Comentarios

La primera columna en orden de presentación es la columna con el valor más bajo DisplayIndex , independientemente de si la columna está realmente visible en la pantalla.

Este método permite determinar la primera columna que se ajusta a los criterios especificados sin tener que comparar los valores de índice directamente.

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?