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