DataGridView.InvalidateCell Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отменяет ячейку в ячейке DataGridView, принудив ее повторно переопределить.
Перегрузки
| Имя | Описание |
|---|---|
| InvalidateCell(DataGridViewCell) |
Отменяет указанную ячейку DataGridViewобъекта, принудив ее переопределить. |
| InvalidateCell(Int32, Int32) |
Отменяет ячейку с указанными индексами строк и столбцов, заставляя ее переопределяет. |
InvalidateCell(DataGridViewCell)
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
Отменяет указанную ячейку DataGridViewобъекта, принудив ее переопределить.
public:
void InvalidateCell(System::Windows::Forms::DataGridViewCell ^ dataGridViewCell);public void InvalidateCell(System.Windows.Forms.DataGridViewCell dataGridViewCell);member this.InvalidateCell : System.Windows.Forms.DataGridViewCell -> unitPublic Sub InvalidateCell (dataGridViewCell As DataGridViewCell)Параметры
- dataGridViewCell
- DataGridViewCell
Недопустимое DataGridViewCell значение.
Исключения
dataGridViewCell не принадлежит к DataGridView.
dataGridViewCell равно null.
Примеры
В следующем примере кода показано, как использовать этот метод в настраиваемом DataGridViewCell объекте, нарисованном с помощью пользовательской границы, когда указатель мыши находится на нем. В примере ячейка недействительна при вводе указателя мыши или его выходе.
Этот код является частью более крупного примера, доступного в How to: Настройка ячеек и столбцов в элементе управления DataGridView Windows Forms путем расширения их поведения и внешнего вида.
// Force the cell to repaint itself when the mouse pointer enters it.
protected override void OnMouseEnter(int rowIndex)
{
this.DataGridView.InvalidateCell(this);
}
// Force the cell to repaint itself when the mouse pointer leaves it.
protected override void OnMouseLeave(int rowIndex)
{
this.DataGridView.InvalidateCell(this);
}
' Force the cell to repaint itself when the mouse pointer enters it.
Protected Overrides Sub OnMouseEnter(ByVal rowIndex As Integer)
Me.DataGridView.InvalidateCell(Me)
End Sub
' Force the cell to repaint itself when the mouse pointer leaves it.
Protected Overrides Sub OnMouseLeave(ByVal rowIndex As Integer)
Me.DataGridView.InvalidateCell(Me)
End Sub
Комментарии
Этот метод полезен для принудительного перезакрепки ячейки в условиях, которые обычно не приводят к переопределению ячейки. Например, этот метод можно использовать с пользовательским типом ячейки, который изменяет внешний вид в результате внешних событий.
Дополнительные сведения о рисовании и недопустимости см. в разделе Invalidate.
См. также раздел
Применяется к
InvalidateCell(Int32, Int32)
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
- Исходный код:
- DataGridView.Methods.cs
Отменяет ячейку с указанными индексами строк и столбцов, заставляя ее переопределяет.
public:
void InvalidateCell(int columnIndex, int rowIndex);public void InvalidateCell(int columnIndex, int rowIndex);member this.InvalidateCell : int * int -> unitPublic Sub InvalidateCell (columnIndex As Integer, rowIndex As Integer)Параметры
- columnIndex
- Int32
Индекс столбца ячейки, который будет недействительным.
- rowIndex
- Int32
Индекс строки ячейки, который требуется сделать недействительным.
Исключения
columnIndex меньше -1 или больше числа столбцов в элементе управления минус 1.
–или–
rowIndex меньше -1 или больше числа строк в элементе управления минус 1.
Примеры
В следующем примере кода показано, как использовать этот метод в пользовательском типе ячейки, который изменяет внешний вид ячейки, когда пользователь отстает указатель мыши над ним. Этот пример является частью более крупного примера, доступного в How to: Настройка ячеек и столбцов в элементе управления DataGridView Windows Forms путем расширения их поведения и внешнего вида.
// Force the cell to repaint itself when the mouse pointer enters it.
protected override void OnMouseEnter(int rowIndex)
{
this.DataGridView.InvalidateCell(this);
}
// Force the cell to repaint itself when the mouse pointer leaves it.
protected override void OnMouseLeave(int rowIndex)
{
this.DataGridView.InvalidateCell(this);
}
' Force the cell to repaint itself when the mouse pointer enters it.
Protected Overrides Sub OnMouseEnter(ByVal rowIndex As Integer)
Me.DataGridView.InvalidateCell(Me)
End Sub
' Force the cell to repaint itself when the mouse pointer leaves it.
Protected Overrides Sub OnMouseLeave(ByVal rowIndex As Integer)
Me.DataGridView.InvalidateCell(Me)
End Sub
Комментарии
Этот метод полезен для принудительного перезакрепки ячейки в условиях, которые обычно не приводят к переопределению ячейки. Например, этот метод можно использовать с пользовательским типом ячейки, который изменяет внешний вид в результате внешних событий.
Дополнительные сведения о рисовании и недопустимости см. в разделе Invalidate.
