Udostępnij za pośrednictwem

DataGridViewColumnCollection.GetFirstColumn Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia podane wymagania filtru.

Przeciążenia

GetFirstColumn(DataGridViewElementStates)

Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru dołączania.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru dołączania i filtrowania wykluczeń.

GetFirstColumn(DataGridViewElementStates)

Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru dołączania.

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

Bitowa kombinacja DataGridViewElementStates wartości reprezentujących filtr do dołączenia.

Zwraca

DataGridViewColumn

Pierwsza kolumna w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru lub null jeśli nie zostanie znaleziona żadna kolumna.

Wyjątki

ArgumentException

includeFilter nie jest prawidłową kombinacją bitów DataGridViewElementStates wartości.

Przykłady

Poniższy przykład kodu używa GetFirstColumn metody do zamiany pierwszej wyświetlanej kolumny i ostatniej wyświetlanej kolumny.

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

Uwagi

Pierwsza kolumna w kolejności wyświetlania to kolumna o najniższej DisplayIndex wartości, niezależnie od tego, czy kolumna jest rzeczywiście widoczna na ekranie.

Ta metoda umożliwia określenie pierwszej kolumny, która spełnia podane kryteria bez konieczności bezpośredniego porównywania wartości indeksu.

Zobacz też

Dotyczy

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru dołączania i filtrowania wykluczeń.

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

Bitowa kombinacja DataGridViewElementStates wartości reprezentujących filtr do zastosowania do dołączenia.

excludeFilter
DataGridViewElementStates

Bitowa kombinacja DataGridViewElementStates wartości reprezentujących filtr do zastosowania do wykluczenia.

Zwraca

DataGridViewColumn

Pierwsza kolumna w kolejności wyświetlania, która spełnia podane wymagania dotyczące filtru lub null jeśli nie zostanie znaleziona żadna kolumna.

Wyjątki

ArgumentException

Co najmniej jedna z wartości filtru nie jest prawidłową kombinacją bitów DataGridViewElementStates wartości.

Uwagi

Pierwsza kolumna w kolejności wyświetlania to kolumna o najniższej DisplayIndex wartości, niezależnie od tego, czy kolumna jest rzeczywiście widoczna na ekranie.

Ta metoda umożliwia określenie pierwszej kolumny, która spełnia podane kryteria bez konieczności bezpośredniego porównywania wartości indeksu.

Zobacz też

Dotyczy