Поделиться через


DataGridViewColumnCollection.GetFirstColumn Метод

Определение

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра.

Перегрузки

GetFirstColumn(DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения.

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения и фильтра исключения.

GetFirstColumn(DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения.

public:
 System::Windows::Forms::DataGridViewColumn ^ GetFirstColumn(System::Windows::Forms::DataGridViewElementStates includeFilter);
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

Параметры

includeFilter
DataGridViewElementStates

Битовая комбинация значений DataGridViewElementStates, представляющая фильтр для включения.

Возвращаемое значение

Первый столбец в порядке отображения, отвечающий заданным требованиям фильтра, или значение null, если столбец не найден.

Исключения

Параметр includeFilter не является допустимой битовой комбинацией значений DataGridViewElementStates.

Примеры

В следующем примере кода метод используется GetFirstColumn для замены первого отображаемого столбца и последнего отображаемого столбца.

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

Комментарии

Первый столбец в порядке отображения — это столбец с наименьшим DisplayIndex значением, независимо от того, отображается ли столбец на экране.

Этот метод позволяет определить первый столбец, соответствующий заданным критериям, без необходимости сравнивать значения индекса напрямую.

См. также раздел

Применяется к

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения и фильтра исключения.

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);
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

Параметры

includeFilter
DataGridViewElementStates

Битовая комбинация значений DataGridViewElementStates, представляющая фильтр, применяемый для включения.

excludeFilter
DataGridViewElementStates

Битовая комбинация значений DataGridViewElementStates, представляющая фильтр, применяемый для исключения.

Возвращаемое значение

Первый столбец в порядке отображения, отвечающий заданным требованиям фильтра, или значение null, если столбец не найден.

Исключения

По крайней мере одно из значений фильтра не является допустимой битовой комбинацией значений DataGridViewElementStates.

Комментарии

Первый столбец в порядке отображения — это столбец с наименьшим DisplayIndex значением, независимо от того, отображается ли столбец на экране.

Этот метод позволяет определить первый столбец, соответствующий заданным критериям, без необходимости сравнивать значения индекса напрямую.

См. также раздел

Применяется к