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 Если элемент управления привязан к внешнему источнику данных, текущая ячейка не сохраняется автоматически при сортировке.
Чтобы выполнить этот пример, вставьте следующий код в форму с 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
Комментарии
При установке ячейки в качестве текущей ячейки она будет прокручиваться в представление, если она не отображается в данный момент. Текущая ячейка не может быть ячейкой заголовка, отключенной ячейкой или ячейкой в скрытой строке или столбце.
Вы можете присвоить этому свойству значение , null чтобы временно удалить прямоугольник фокуса, но когда элемент управления получает фокус и значение этого свойства равно null, ему автоматически присваивается значение FirstDisplayedCell свойства .
При изменении значения этого свойства SelectionChanged событие происходит до CurrentCellChanged события . Любой SelectionChanged обработчик событий, обращаюсь к свойству CurrentCell в данный момент, получит предыдущее значение.
При привязке к внешнему источнику DataGridView данных это свойство сбрасывается до значения по умолчанию.
