DataGridViewColumnCollection.GetFirstColumn Метод

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

Параметры

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

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

Исключения

Примеры

В следующем примере кода метод используется 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

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

Параметры

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

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

Исключения

Комментарии

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

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

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

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates