DataGridViewColumnCollection.GetFirstColumn Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Перегрузки

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

member this.GetFirstColumn : System.Windows.Forms.DataGridViewElementStates -> System.Windows.Forms.DataGridViewColumn

Public Function GetFirstColumn (includeFilter As DataGridViewElementStates) As DataGridViewColumn

Параметры

includeFilter

DataGridViewElementStates

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

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

DataGridViewColumn

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

Исключения

ArgumentException

Параметр 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 значением, независимо от того, отображается ли столбец на экране.

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

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

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates

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

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, представляющая фильтр, применяемый для исключения.

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

DataGridViewColumn

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

Исключения

ArgumentException

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

Комментарии

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

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

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

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates