DataGridView.InvalidateRow メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridView.InvalidateRow メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridView の指定された行を無効化して、強制的に再描画します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Sub InvalidateRow ( _
    rowIndex As Integer _
)

Visual Basic (使用法)

Dim instance As DataGridView
Dim rowIndex As Integer

instance.InvalidateRow(rowIndex)

C#

public void InvalidateRow (
    int rowIndex
)

C++

public:
void InvalidateRow (
    int rowIndex
)

J#

public void InvalidateRow (
    int rowIndex
)

JScript

public function InvalidateRow (
    rowIndex : int
)

パラメータ

rowIndex

無効化する行のインデックス。

例外

例外の種類	条件
ArgumentOutOfRangeException	rowIndex が有効な範囲 (0 ～行数 - 1) 内にありません。

解説

行を強制的に再描画するには、このメソッドを使用します。このメソッドは、RowPrePaint イベントまたは RowPostPaint イベントを処理するオーナー描画の場合に役に立ちます。

描画と無効化の詳細については、「Invalidate」を参照してください。

使用例

行を描画するシナリオで InvalidateRow メソッドを使用する方法のコード例を次に示します。この例では、現在のセルが変更されたときに行が無効化され、行が強制的に再描画されます。

ここに示すコードは、「方法 : Windows フォームの DataGridView コントロールの行の外観をカスタマイズする」で取り上げられているコードの一部です。

Visual Basic

' Forces the row to repaint itself when the user changes the 
' current cell. This is necessary to refresh the focus rectangle.
Sub dataGridView1_CurrentCellChanged(ByVal
 sender As Object, _
    ByVal e As EventArgs) Handles
 dataGridView1.CurrentCellChanged

    If oldRowIndex <> -1 Then
        Me.dataGridView1.InvalidateRow(oldRowIndex)
    End If
    oldRowIndex = Me.dataGridView1.CurrentCellAddress.Y

End Sub 'dataGridView1_CurrentCellChanged

C#

// Forces the row to repaint itself when the user changes the 
// current cell. This is necessary to refresh the focus rectangle.
void dataGridView1_CurrentCellChanged(object sender, EventArgs
 e)
{
    if (oldRowIndex != -1)
    {
        this.dataGridView1.InvalidateRow(oldRowIndex);
    }
    oldRowIndex = this.dataGridView1.CurrentCellAddress.Y;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
Invalidate
その他の技術情報
DataGridView コントロール (Windows フォーム)