DataGridViewColumnCollection.GetFirstColumn Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vrátí první sloupec v pořadí zobrazení, který splňuje dané požadavky filtru.

Přetížení

GetFirstColumn(DataGridViewElementStates)	Vrátí první sloupec v pořadí zobrazení, který splňuje dané požadavky filtru zahrnutí.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Vrátí první sloupec v pořadí zobrazení, který splňuje dané požadavky filtru zahrnutí a filtru vyloučení.

GetFirstColumn(DataGridViewElementStates)

Vrátí první sloupec v pořadí zobrazení, který splňuje dané požadavky filtru zahrnutí.

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

Parametry

includeFilter

DataGridViewElementStates

Bitové kombinace DataGridViewElementStates hodnot, které představují filtr pro zahrnutí.

Návraty

DataGridViewColumn

První sloupec v pořadí zobrazení, který splňuje dané požadavky filtru, nebo null pokud nebyl nalezen žádný sloupec.

Výjimky

ArgumentException

includeFilter není platná bitové kombinace DataGridViewElementStates hodnot.

Příklady

Následující příklad kódu používá metodu GetFirstColumn prohození prvního zobrazeného sloupce a posledního zobrazeného sloupce.

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

Poznámky

První sloupec v pořadí zobrazení je sloupec s nejnižší DisplayIndex hodnotou bez ohledu na to, jestli je sloupec ve skutečnosti viditelný na obrazovce.

Tato metoda umožňuje určit první sloupec, který odpovídá zadaným kritériím, aniž byste museli porovnávat hodnoty indexu přímo.

Viz také

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Vrátí první sloupec v pořadí zobrazení, který splňuje dané požadavky filtru zahrnutí a filtru vyloučení.

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

Parametry

includeFilter

DataGridViewElementStates

Bitové kombinace DataGridViewElementStates hodnot, které představují filtr, který se má použít pro zahrnutí.

excludeFilter

DataGridViewElementStates

Bitové kombinace DataGridViewElementStates hodnot, které představují filtr, který se má použít pro vyloučení.

Návraty

DataGridViewColumn

První sloupec v pořadí zobrazení, který splňuje dané požadavky filtru, nebo null pokud nebyl nalezen žádný sloupec.

Výjimky

ArgumentException

Alespoň jedna z hodnot filtru není platná bitové kombinace DataGridViewElementStates hodnot.

Poznámky

První sloupec v pořadí zobrazení je sloupec s nejnižší DisplayIndex hodnotou bez ohledu na to, jestli je sloupec ve skutečnosti viditelný na obrazovce.

Tato metoda umožňuje určit první sloupec, který odpovídá zadaným kritériím, aniž byste museli porovnávat hodnoty indexu přímo.

Viz také

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates