DataGridView.SetCurrentCellAddressCore Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает ячейку, которая является активной в данный момент.
protected:
virtual bool SetCurrentCellAddressCore(int columnIndex, int rowIndex, bool setAnchorCellAddress, bool validateCurrentCell, bool throughMouseClick);
protected virtual bool SetCurrentCellAddressCore (int columnIndex, int rowIndex, bool setAnchorCellAddress, bool validateCurrentCell, bool throughMouseClick);
abstract member SetCurrentCellAddressCore : int * int * bool * bool * bool -> bool
override this.SetCurrentCellAddressCore : int * int * bool * bool * bool -> bool
Protected Overridable Function SetCurrentCellAddressCore (columnIndex As Integer, rowIndex As Integer, setAnchorCellAddress As Boolean, validateCurrentCell As Boolean, throughMouseClick As Boolean) As Boolean
Параметры
- columnIndex
- Int32
Индекс столбца, содержащего ячейку.
- rowIndex
- Int32
Индекс строки, содержащей ячейку.
- setAnchorCellAddress
- Boolean
Значение true
, чтобы сделать новую текущую ячейку ячейкой привязки для последующего выбора нескольких ячеек, выполняемого с использованием клавиши SHIFT; в противном случае — значение false
.
- validateCurrentCell
- Boolean
Значение true
, чтобы проверить значение в старой текущей ячейке и отменить изменение при сбое проверки; в противном случае — значение false
.
- throughMouseClick
- Boolean
Значение true
, если текущая ячейка задается в результате щелчка кнопкой мыши; в противном случае — значение false
.
Возвращаемое значение
Значение true
, если текущая ячейка была успешно установлена; в противном случае — значение false
.
Исключения
Значение columnIndex
меньше 0 или больше количества столбцов в элементе управления минус 1, а rowIndex
не равен –1.
-или-
ЗначениеrowIndex
меньше 0 или больше количества строк в элементе управления минус 1, а columnIndex
не равен –1.
Указанная ячейка имеет значение false
свойства Visible.
-или- Этот метод был вызван не по причине сброса базового источника данных, и другой поток в данный момент выполняет этот метод.
Новая текущая ячейка попыталась перейти в режим редактирования, но ее свойство EditType не указывает класс, производный от Control и реализующий IDataGridViewEditingControl.
Комментарии
Элемент DataGridView управления использует этот метод при каждом изменении текущей ячейки. Этот метод изменяет текущую ячейку, не изменяя выделение и не проверяя предыдущую ячейку или не изменяя ячейку привязки выделения. Ячейка привязки — это первая ячейка блока нескольких ячеек, которую пользователь может выбрать, удерживая клавишу SHIFT и щелкнув последнюю ячейку блока.
Если rowIndex
и оба значения columnIndex
имеют значение -1, CurrentCell то возвращается null
свойство.