DataGridView.InvalidateCell Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Делает недействительной ячейку в объекте DataGridView, принудительно вызывая ее повторное окрашивание.

Перегрузки

InvalidateCell(DataGridViewCell)	Делает недействительной указанную ячейку объекта DataGridView, принудительно вызывая ее повторное окрашивание.
InvalidateCell(Int32, Int32)	Делает недействительной ячейку с указанными индексами строки и столбца, принудительно вызывая ее повторное окрашивание.

InvalidateCell(DataGridViewCell)

Делает недействительной указанную ячейку объекта DataGridView, принудительно вызывая ее повторное окрашивание.

public:
 void InvalidateCell(System::Windows::Forms::DataGridViewCell ^ dataGridViewCell);

public void InvalidateCell (System.Windows.Forms.DataGridViewCell dataGridViewCell);

member this.InvalidateCell : System.Windows.Forms.DataGridViewCell -> unit

Public Sub InvalidateCell (dataGridViewCell As DataGridViewCell)

Параметры

dataGridViewCell

DataGridViewCell

Объект DataGridViewCell, который делается недействительным.

Исключения

ArgumentException

Объект dataGridViewCell не принадлежит к DataGridView.

ArgumentNullException

dataGridViewCell имеет значение null.

Примеры

В следующем примере кода показано, как использовать этот метод в настраиваемом объекте, нарисованном DataGridViewCell с помощью настраиваемой границы при наведении указателя мыши на него. В этом примере ячейка становится недопустимой при вводе указателя мыши или выходе из нее.

Этот код является частью более крупного примера, доступного в разделе "Практическое руководство. Настройка ячеек и столбцов в элементе управления 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.

См. также раздел

• Invalidate
• элемент управления DataGridView (Windows Forms)

InvalidateCell(Int32, Int32)

Делает недействительной ячейку с указанными индексами строки и столбца, принудительно вызывая ее повторное окрашивание.

public:
 void InvalidateCell(int columnIndex, int rowIndex);

public void InvalidateCell (int columnIndex, int rowIndex);

member this.InvalidateCell : int * int -> unit

Public Sub InvalidateCell (columnIndex As Integer, rowIndex As Integer)

Параметры

columnIndex

Int32

Индекс столбца ячейки, которую требуется сделать недействительной.

rowIndex

Int32

Индекс строки ячейки, которую требуется сделать недействительной.

Исключения

ArgumentOutOfRangeException

Значение columnIndex меньше –1 или больше количества столбцов в элементе управления минус 1.

-или- Значение rowIndex меньше –1 или больше количества строк в элементе управления минус 1.

Примеры

В следующем примере кода показано, как использовать этот метод в пользовательском типе ячейки, который изменяет внешний вид ячейки при наведении указателя мыши на него. Этот пример является частью более крупного примера, доступного в разделе "Практическое руководство. Настройка ячеек и столбцов в элементе управления 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.

См. также раздел

• Invalidate
• элемент управления DataGridView (Windows Forms)