DataGridViewColumnCollection.GetFirstColumn 方法

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回显示顺序满足给定筛选器要求的第一列。

重载

名称	说明
GetFirstColumn(DataGridViewElementStates)	返回显示顺序满足给定包含筛选器要求的第一列。
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	返回显示顺序满足给定包含筛选器和排除筛选器要求的第一列。

GetFirstColumn(DataGridViewElementStates)

Source:: DataGridViewColumnCollection.cs

Source:: DataGridViewColumnCollection.cs

Source:: DataGridViewColumnCollection.cs

Source:: DataGridViewColumnCollection.cs

Source:: DataGridViewColumnCollection.cs

返回显示顺序满足给定包含筛选器要求的第一列。

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 按位组合。

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 值的列，无论该列是否在屏幕上实际可见。

使用此方法可以确定符合给定条件的第一列，而无需直接比较索引值。

另请参阅

适用于

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Source:: DataGridViewColumnCollection.cs

Source:: DataGridViewColumnCollection.cs

Source:: DataGridViewColumnCollection.cs

Source:: DataGridViewColumnCollection.cs

Source:: DataGridViewColumnCollection.cs

返回显示顺序满足给定包含筛选器和排除筛选器要求的第一列。

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 按位组合。