Compartir vía

DataGridViewColumnCollection.GetFirstColumn Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

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

Sobrecargas

GetFirstColumn(DataGridViewElementStates)

Devuelve la primera columna en el orden de presentación que cumple los requisitos de filtro-inclusión especificados.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

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

GetFirstColumn(DataGridViewElementStates)

Devuelve la primera columna en el orden de presentación que cumple los requisitos de filtro-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

Una combinación bit a bit de los valores DataGridViewElementStates que representan el filtro para la inclusión.

Devoluciones

DataGridViewColumn

La primera columna en el 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 valores DataGridViewElementStates.

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 visualizació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 el orden de presentación que cumple los requisitos de filtro de inclusión y de filtro de exclusión especificados.

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 valores DataGridViewElementStates que representan el filtro que se va a aplicar a la inclusión.

excludeFilter
DataGridViewElementStates

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

Devoluciones

DataGridViewColumn

La primera columna en el 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 los valores DataGridViewElementStates.

Comentarios

La primera columna en orden de visualizació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