DataGridViewColumnCollection.GetFirstColumn Метод

Определение

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра.Returns the first column in display order that meets the given filter requirements.

Перегрузки

GetFirstColumn(DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения.Returns the first column in display order that meets the given inclusion-filter requirements.

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения и фильтра исключения.Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements.

GetFirstColumn(DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения.Returns the first column in display order that meets the given inclusion-filter requirements.

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, представляющая фильтр для включения.A bitwise combination of the DataGridViewElementStates values that represents the filter for inclusion.

Возвраты

Первый столбец в порядке отображения, отвечающий заданным требованиям фильтра, или значение null, если столбец не найден.The first column in display order that meets the given filter requirements, or null if no column is found.

Исключения

Параметр includeFilter не является допустимой битовой комбинацией значений DataGridViewElementStates.includeFilter is not a valid bitwise combination of DataGridViewElementStates values.

Примеры

В следующем примере кода GetFirstColumn метод используется для переключения первого отображаемого столбца и последнего отображаемого столбца.The following code example uses the GetFirstColumn method to swap the first displayed column and the last displayed column.

// 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 значением, независимо от того, является ли столбец видимым на экране.The first column in display order is the column with the lowest DisplayIndex value, regardless of whether the column is actually visible on the screen.

Этот метод позволяет определить первый столбец, соответствующий заданным критериям, без необходимости непосредственного сравнения значений индексов.This method lets you determine the first column that fits the given criteria without having to compare index values directly.

Дополнительно

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Возвращает первый столбец в порядке отображения, отвечающий заданным требованиям фильтра включения и фильтра исключения.Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements.

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, представляющая фильтр, применяемый для включения.A bitwise combination of the DataGridViewElementStates values that represent the filter to apply for inclusion.

excludeFilter
DataGridViewElementStates

Битовая комбинация значений DataGridViewElementStates, представляющая фильтр, применяемый для исключения.A bitwise combination of the DataGridViewElementStates values that represent the filter to apply for exclusion.

Возвраты

Первый столбец в порядке отображения, отвечающий заданным требованиям фильтра, или значение null, если столбец не найден.The first column in display order that meets the given filter requirements, or null if no column is found.

Исключения

По крайней мере одно из значений фильтра не является допустимой битовой комбинацией значений DataGridViewElementStates.At least one of the filter values is not a valid bitwise combination of DataGridViewElementStates values.

Комментарии

Первый столбец в порядке отображения — это столбец с наименьшим DisplayIndex значением, независимо от того, является ли столбец видимым на экране.The first column in display order is the column with the lowest DisplayIndex value, regardless of whether the column is actually visible on the screen.

Этот метод позволяет определить первый столбец, соответствующий заданным критериям, без необходимости непосредственного сравнения значений индексов.This method lets you determine the first column that fits the given criteria without having to compare index values directly.

Дополнительно

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