DataGridView.InvalidateCell メソッド

定義

DataGridView のセルを無効化して、強制的に再描画します。Invalidates a cell in the DataGridView, forcing it to be repainted.

オーバーロード

InvalidateCell(DataGridViewCell)

DataGridView の指定されたセルを無効化して、強制的に再描画します。Invalidates the specified cell of the DataGridView, forcing it to be repainted.

InvalidateCell(Int32, Int32)

指定された行インデックスと列インデックスを含むセルを無効化して、強制的に再描画します。Invalidates the cell with the specified row and column indexes, forcing it to be repainted.

InvalidateCell(DataGridViewCell)

DataGridView の指定されたセルを無効化して、強制的に再描画します。Invalidates the specified cell of the DataGridView, forcing it to be repainted.

public:
 void InvalidateCell(System::Windows::Forms::DataGridViewCell ^ dataGridViewCell);
public void InvalidateCell (System.Windows.Forms.DataGridViewCell dataGridViewCell);
member this.InvalidateCell : System.Windows.Forms.DataGridViewCell -> unit

パラメーター

dataGridViewCell
DataGridViewCell

無効化する DataGridViewCellThe DataGridViewCell to invalidate.

例外

dataGridViewCellDataGridView に属していません。dataGridViewCell does not belong to the DataGridView.

dataGridViewCellnullです。dataGridViewCell is null.

次のコード例は、マウスポインターが上に置かれたときにカスタム境界線で描画されるカスタマイズされた @no__t 0 でこのメソッドを使用する方法を示しています。The following code example illustrates how to use this method in a customized DataGridViewCell that is painted with a custom border when the mouse pointer rests on it. この例では、マウスポインターがセルを入力または離れると、セルは無効になります。In the example, the cell is invalidated when the mouse pointer enters or leaves it.

このコードは、@no__t で使用できる大規模な例の一部であり、次の方法があります。Windows フォーム DataGridView コントロールのセルと列をカスタマイズするには、動作と外観を拡張する @ no__t-0 を指定します。This code is part of a larger example available in How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Extending Their Behavior and Appearance.

// 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

注釈

このメソッドは、通常、セルが再描画されない条件でセルの再描画を強制する場合に便利です。This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. たとえば、外部イベントの結果として外観を変更するカスタムセル型でこのメソッドを使用できます。For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

描画と無効化の詳細については、「Invalidate」を参照してください。For more information about painting and invalidation, see Invalidate.

こちらもご覧ください

InvalidateCell(Int32, Int32)

指定された行インデックスと列インデックスを含むセルを無効化して、強制的に再描画します。Invalidates the cell with the specified row and column indexes, forcing it to be repainted.

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

無効化するセルの列インデックス。The column index of the cell to invalidate.

rowIndex
Int32

無効化するセルの行インデックス。The row index of the cell to invalidate.

例外

columnIndex が -1 未満か、コントロールの列数 -1 を上回っています。columnIndex is less than -1 or greater than the number of columns in the control minus 1.

- または --or- rowIndex が、-1 未満か、コントロール内の行数から 1 を引いた値を超えています。rowIndex is less than -1 or greater than the number of rows in the control minus 1.

次のコード例は、ユーザーがマウスポインターを置いたときにセルの外観を変更するカスタムセル型でこのメソッドを使用する方法を示しています。The following code example illustrates how to use this method in a custom cell type that changes a cell's appearance when the user rests the mouse pointer over it. この例は、@no__t で使用できる大規模な例の一部であり、次の方法で使用できます。Windows フォーム DataGridView コントロールのセルと列をカスタマイズするには、動作と外観を拡張する @ no__t-0 を指定します。This example is part of a larger example available in How to: Customize Cells and Columns in the Windows Forms DataGridView Control by Extending Their Behavior and Appearance.

// 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

注釈

このメソッドは、通常、セルが再描画されない条件でセルの再描画を強制する場合に便利です。This method is useful to force a cell repaint in conditions that would not normally cause a cell to be repainted. たとえば、外部イベントの結果として外観を変更するカスタムセル型でこのメソッドを使用できます。For example, you can use this method with a custom cell type that changes its appearance as a result of external events.

描画と無効化の詳細については、「Invalidate」を参照してください。For more information about painting and invalidation, see Invalidate.

こちらもご覧ください

適用対象