DataGridViewRowPrePaintEventArgs.PaintCellsBackground メソッド

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

DataGridViewRowPrePaintEventArgs.PaintCellsBackground メソッド

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

指定した境界内の領域に対応するセルの背景を描画します。

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

Visual Basic (宣言)

Public Sub PaintCellsBackground ( _
    clipBounds As Rectangle, _
    cellsPaintSelectionBackground As Boolean
 _
)

Visual Basic (使用法)

Dim instance As DataGridViewRowPrePaintEventArgs
Dim clipBounds As Rectangle
Dim cellsPaintSelectionBackground As Boolean

instance.PaintCellsBackground(clipBounds, cellsPaintSelectionBackground)

C#

public void PaintCellsBackground (
    Rectangle clipBounds,
    bool cellsPaintSelectionBackground
)

C++

public:
void PaintCellsBackground (
    Rectangle clipBounds, 
    bool cellsPaintSelectionBackground
)

J#

public void PaintCellsBackground (
    Rectangle clipBounds, 
    boolean cellsPaintSelectionBackground
)

JScript

public function PaintCellsBackground (
    clipBounds : Rectangle, 
    cellsPaintSelectionBackground : boolean
)

パラメータ

clipBounds

描画が必要な DataGridView の領域を表す Rectangle。

cellsPaintSelectionBackground

DataGridViewRow.InheritedStyle の SelectionBackColor プロパティの色で、指定した境界の背景を描画する場合は true。DataGridViewRow.InheritedStyle の BackColor プロパティの色で、指定した境界の背景を描画する場合は false。

例外

例外の種類	条件
InvalidOperationException	RowIndex が 0 未満か、DataGridView コントロールの行数から 1 を引いた値を上回っています。

解説

DataGridViewRow およびそのセルの内容を自分で描画する場合は、PaintCellsBackground メソッドを使用します。行全体およびそのセルの内容を手動で描画する場合は、HandledEventArgs.Handled プロパティを true に設定します。HandledEventArgs.Handled が true の場合、CellPainting イベントおよび RowPostPaint イベントは発生しません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
DataGridViewRowPrePaintEventArgs クラス
DataGridViewRowPrePaintEventArgs メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewRow クラス
DataGridViewCellStyle.BackColor プロパティ
DataGridViewCellStyle.SelectionBackColor プロパティ
HandledEventArgs.Handled