DataGridView.CurrentCell Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает текущую активную ячейку.
public:
property System::Windows::Forms::DataGridViewCell ^ CurrentCell { System::Windows::Forms::DataGridViewCell ^ get(); void set(System::Windows::Forms::DataGridViewCell ^ value); };[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell CurrentCell { get; set; }[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.DataGridViewCell? CurrentCell { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.CurrentCell : System.Windows.Forms.DataGridViewCell with get, setPublic Property CurrentCell As DataGridViewCellЗначение свойства
Объект DataGridViewCell , представляющий текущую ячейку или null если нет текущей ячейки. Значение по умолчанию — это первая ячейка в первом столбце или null если в элементе управления нет ячеек.
- Атрибуты
Исключения
Значение этого свойства нельзя задать, так как изменения текущей ячейки не могут быть зафиксированы или отменены.
–или–
Указанная ячейка при настройке этого свойства находится в скрытой строке или столбце.
Повторное вызовы записей разрешены только при DataGridView привязке к объекту DataSource. Повторное запись вызывает результаты изменения базовых данных.
Указанная ячейка при задании DataGridViewэтого свойства не находится в .
Примеры
В следующем примере кода показано, как убедиться, что текущая ячейка видна после сортировки путем задания FirstDisplayedCell свойства ячейке CurrentCell , полученной через свойство. Этот код работает только с несвязанным DataGridView элементом управления. DataGridView При привязке элемента управления к внешнему источнику данных текущая ячейка не сохраняется автоматически при сортировке.
Чтобы запустить этот пример, вставьте следующий код в форму, содержащую именованный DataGridViewdataGridView1код. В 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
Комментарии
При установке ячейки в качестве текущей ячейки она будет прокручиваться в представление, если она не отображается в данный момент. Текущая ячейка не может быть ячейкой заголовка, отключенной ячейкой или ячейкой в скрытой строке или столбце.
Это свойство можно задать для null временного удаления прямоугольника фокуса, но когда элемент управления получает фокус и значение этого свойства null, оно автоматически задается значением FirstDisplayedCell свойства.
При изменении значения этого свойства SelectionChanged событие происходит перед событием CurrentCellChanged . В настоящее время любой SelectionChanged обработчик событий, обращаюющийся к свойству CurrentCell , получит предыдущее значение.
При привязке DataGridView к внешнему источнику данных это свойство сбрасывается в значение по умолчанию.
