DataGridView.FirstDisplayedCell 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置当前显示在 DataGridView 中的第一个单元格；此单元格通常位于左上角。

public:
 property System::Windows::Forms::DataGridViewCell ^ FirstDisplayedCell { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell FirstDisplayedCell { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.FirstDisplayedCell : System.Windows.Forms.DataGridViewCell with get, set

Public Property FirstDisplayedCell As DataGridViewCell

属性值

DataGridViewCell

当前显示在控件中的第一个 DataGridViewCell。

属性

BrowsableAttribute

例外

ArgumentException

设置此属性时，指定的单元格不在 DataGridView 中。

InvalidOperationException

当设置此属性时，指定的单元格的 RowIndex 或 ColumnIndex 属性值为 -1，指示它为标题单元格或共享单元格。

- 或 -

当设置此属性时，指定的单元格的 Visible 属性值为 false。

示例

下面的代码示例演示了如何确保当前单元格在排序后可见。 此代码仅适用于未绑定 DataGridView 控件。 DataGridView如果控件绑定到外部数据源，则排序时不会自动保留当前单元格。

若要运行此示例，请将以下代码粘贴到包含名为 dataGridView1的DataGridView窗体中。 在 C# 中，还必须将 Sorted 事件连接到事件处理程序。

private void dataGridView1_Sorted(object sender, EventArgs e)
{
    this.dataGridView1.FirstDisplayedCell = this.dataGridView1.CurrentCell;
}

Private Sub dataGridView1_Sorted(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles dataGridView1.Sorted

    Me.dataGridView1.FirstDisplayedCell = Me.dataGridView1.CurrentCell

End Sub

注解

可以使用此属性来确定控件中当前显示的第一行和列中的单元格。 通常，它位于左上角，但对于从右到左的语言，它位于右上角。 还可以将此属性设置为将控件滚动到指示的单元格。

另请参阅

• CurrentCell
• DataGridView 控件（Windows 窗体）