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 Если элемент управления привязан к внешнему источнику данных, текущая ячейка не сохраняется автоматически при сортировке.

Чтобы запустить этот пример, вставьте следующий код в форму, содержащую DataGridView с именем dataGridView1. В 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 Forms)