DataGridViewRowPrePaintEventArgsとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

DataGridViewRowPrePaintEventArgs クラス

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

RowPrePaint イベントのデータを提供します。

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

Visual Basic (宣言)

Public Class DataGridViewRowPrePaintEventArgs
    Inherits HandledEventArgs

Visual Basic (使用法)

Dim instance As DataGridViewRowPrePaintEventArgs

public class DataGridViewRowPrePaintEventArgs
 : HandledEventArgs

C++

public ref class DataGridViewRowPrePaintEventArgs
 : public HandledEventArgs

public class DataGridViewRowPrePaintEventArgs
 extends HandledEventArgs

JScript

public class DataGridViewRowPrePaintEventArgs
 extends HandledEventArgs

解説

RowPrePaint イベントは、行が DataGridView コントロール上に描画される前に発生します。RowPrePaint を使用すると、行内のセルが描画される前に、行の外観を手動で調整できます。これは、1 つの列の内容が複数の列にまたがる行の作成など、行をカスタマイズする場合に便利です。DataGridView の行に直接アクセスせずに行の設定を取得するには、DataGridViewRowPrePaintEventArgs のプロパティを使用します。

使用例

RowPrePaint イベントを処理して、選択されたセルのカスタムの背景を描画する方法を次のコード例に示します。次のコード例は、「方法 : Windows フォームの DataGridView コントロールの行の外観をカスタマイズする」で示されている例の一部です。

Visual Basic

' Paints the custom selection background for selected rows.
Sub dataGridView1_RowPrePaint(ByVal sender
 As Object, _
    ByVal e As DataGridViewRowPrePaintEventArgs)
 _
    Handles dataGridView1.RowPrePaint

    ' Do not automatically paint the focus rectangle.
    e.PaintParts = e.PaintParts And Not DataGridViewPaintParts.Focus

    ' Determine whether the cell should be painted with the 
    ' custom selection background.
    If (e.State And DataGridViewElementStates.Selected)
 = _
        DataGridViewElementStates.Selected Then

        ' Calculate the bounds of the row.
        Dim rowBounds As New
 Rectangle( _
            Me.dataGridView1.RowHeadersWidth, e.RowBounds.Top,
 _
            Me.dataGridView1.Columns.GetColumnsWidth( _
            DataGridViewElementStates.Visible) - _
            Me.dataGridView1.HorizontalScrollingOffset + 1, _
            e.RowBounds.Height)

        ' Paint the custom selection background.
        Dim backbrush As New
 _
            System.Drawing.Drawing2D.LinearGradientBrush(rowBounds, _
            Me.dataGridView1.DefaultCellStyle.SelectionBackColor,
 _
            e.InheritedRowStyle.ForeColor, _
            System.Drawing.Drawing2D.LinearGradientMode.Horizontal)
        Try
            e.Graphics.FillRectangle(backbrush, rowBounds)
        Finally
            backbrush.Dispose()
        End Try
    End If

End Sub 'dataGridView1_RowPrePaint

// Paints the custom selection background for selected rows.
void dataGridView1_RowPrePaint(object sender,
        DataGridViewRowPrePaintEventArgs e)
{
    // Do not automatically paint the focus rectangle.
    e.PaintParts &= ~DataGridViewPaintParts.Focus;

    // Determine whether the cell should be painted
    // with the custom selection background.
    if ((e.State & DataGridViewElementStates.Selected) ==
                DataGridViewElementStates.Selected)
    {
        // Calculate the bounds of the row.
        Rectangle rowBounds = new Rectangle(
            this.dataGridView1.RowHeadersWidth, e.RowBounds.Top
,
            this.dataGridView1.Columns.GetColumnsWidth(
                DataGridViewElementStates.Visible) -
            this.dataGridView1.HorizontalScrollingOffset + 1,
            e.RowBounds.Height);

        // Paint the custom selection background.
        using (Brush backbrush =
            new System.Drawing.Drawing2D.LinearGradientBrush(rowBounds
,
                this.dataGridView1.DefaultCellStyle.SelectionBackColor
,
                e.InheritedRowStyle.ForeColor,
                System.Drawing.Drawing2D.LinearGradientMode.Horizontal))
        {
            e.Graphics.FillRectangle(backbrush, rowBounds);
        }
    }
}

継承階層

System.Object
   System.EventArgs
     System.ComponentModel.HandledEventArgs
      System.Windows.Forms.DataGridViewRowPrePaintEventArgs

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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 メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.RowPrePaint イベント

DataGridViewRowPrePaintEventArgs コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridViewRowPrePaintEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    dataGridView As DataGridView, _
    graphics As Graphics, _
    clipBounds As Rectangle, _
    rowBounds As Rectangle, _
    rowIndex As Integer, _
    rowState As DataGridViewElementStates, _
    errorText As String, _
    inheritedRowStyle As DataGridViewCellStyle, _
    isFirstDisplayedRow As Boolean, _
    isLastVisibleRow As Boolean _
)

Visual Basic (使用法)

Dim dataGridView As DataGridView
Dim graphics As Graphics
Dim clipBounds As Rectangle
Dim rowBounds As Rectangle
Dim rowIndex As Integer
Dim rowState As DataGridViewElementStates
Dim errorText As String
Dim inheritedRowStyle As DataGridViewCellStyle
Dim isFirstDisplayedRow As Boolean
Dim isLastVisibleRow As Boolean

Dim instance As New DataGridViewRowPrePaintEventArgs(dataGridView,
 graphics, clipBounds, rowBounds, rowIndex, rowState, errorText, inheritedRowStyle,
 isFirstDisplayedRow, isLastVisibleRow)

public DataGridViewRowPrePaintEventArgs (
    DataGridView dataGridView,
    Graphics graphics,
    Rectangle clipBounds,
    Rectangle rowBounds,
    int rowIndex,
    DataGridViewElementStates rowState,
    string errorText,
    DataGridViewCellStyle inheritedRowStyle,
    bool isFirstDisplayedRow,
    bool isLastVisibleRow
)

C++

public:
DataGridViewRowPrePaintEventArgs (
    DataGridView^ dataGridView, 
    Graphics^ graphics, 
    Rectangle clipBounds, 
    Rectangle rowBounds, 
    int rowIndex, 
    DataGridViewElementStates rowState, 
    String^ errorText, 
    DataGridViewCellStyle^ inheritedRowStyle, 
    bool isFirstDisplayedRow, 
    bool isLastVisibleRow
)

public DataGridViewRowPrePaintEventArgs (
    DataGridView dataGridView, 
    Graphics graphics, 
    Rectangle clipBounds, 
    Rectangle rowBounds, 
    int rowIndex, 
    DataGridViewElementStates rowState, 
    String errorText, 
    DataGridViewCellStyle inheritedRowStyle, 
    boolean isFirstDisplayedRow, 
    boolean isLastVisibleRow
)

JScript

public function DataGridViewRowPrePaintEventArgs
 (
    dataGridView : DataGridView, 
    graphics : Graphics, 
    clipBounds : Rectangle, 
    rowBounds : Rectangle, 
    rowIndex : int, 
    rowState : DataGridViewElementStates, 
    errorText : String, 
    inheritedRowStyle : DataGridViewCellStyle, 
    isFirstDisplayedRow : boolean, 
    isLastVisibleRow : boolean
)

パラメータ

dataGridView: 描画される行を所有する DataGridView。

graphics: DataGridViewRow の描画に使用する Graphics。

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

rowBounds: 描画される DataGridViewRow の境界が格納された Rectangle。

rowIndex: 描画されるセルの行インデックス。

rowState: 行の状態を指定する DataGridViewElementStates 値のビットごとの組み合わせ。

errorText: 行に関連付けられたエラーメッセージ。

inheritedRowStyle: 行に関する書式とスタイルの情報が格納された DataGridViewCellStyle。

isFirstDisplayedRow: 現在の行が、現在 DataGridView に表示されている最初の行かどうかを示す場合は true。それ以外の場合は false。

isLastVisibleRow: 現在の行が、Visible プロパティが true に設定された、DataGridView の最後の行かどうかを示す場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	dataGridView が null 参照 (Visual Basic では Nothing) です。または graphics が null 参照 (Visual Basic では Nothing) です。または inheritedRowStyle が null 参照 (Visual Basic では Nothing) です。

例外の種類

条件

ArgumentNullException

dataGridView が null 参照 (Visual Basic では Nothing) です。

または

graphics が null 参照 (Visual Basic では Nothing) です。

または

inheritedRowStyle が null 参照 (Visual Basic では Nothing) です。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewRowPrePaintEventArgs クラス
DataGridViewRowPrePaintEventArgs メンバ
System.Windows.Forms 名前空間
DataGridView クラス
Graphics
Rectangle
DataGridViewRow クラス
DataGridViewElementStates 列挙体
DataGridViewCellStyle クラス

DataGridViewRowPrePaintEventArgs プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	ClipBounds	再描画が必要な DataGridView の領域を取得または設定します。
	ErrorText	現在の DataGridViewRow のエラーメッセージを表す文字列を取得します。
	Graphics	現在の DataGridViewRow の描画に使用される Graphics を取得します。
	Handled	イベントハンドラがイベントを完全に処理したかどうか、またはシステムが独自の処理を継続する必要があるかどうかを示す値を取得または設定します。 ( HandledEventArgs から継承されます。)
	InheritedRowStyle	行に適用されるセルスタイルを取得します。
	IsFirstDisplayedRow	現在の行が、DataGridView に現在表示されている最初の行かどうかを示す値を取得します。
	IsLastVisibleRow	現在の行が DataGridView に表示される最後の行かどうかを示す値を取得します。
	PaintParts	描画されるセル部分。
	RowBounds	現在の DataGridViewRow の境界を取得します。
	RowIndex	現在の DataGridViewRow のインデックスを取得します。
	State	現在の DataGridViewRow の状態を取得します。

参照

DataGridViewRowPrePaintEventArgs メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	DrawFocus	指定した境界の周囲にフォーカスを表す四角形を描画します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	PaintCells	指定した境界内の領域に対応する指定したセルの部分を描画します。
	PaintCellsBackground	指定した境界内の領域に対応するセルの背景を描画します。
	PaintCellsContent	指定した境界内の領域に対応するセルの内容を描画します。
	PaintHeader	オーバーロードされます。現在の行の行ヘッダーを描画します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

DataGridViewRowPrePaintEventArgs メンバ

RowPrePaint イベントのデータを提供します。

DataGridViewRowPrePaintEventArgs データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	DataGridViewRowPrePaintEventArgs	DataGridViewRowPrePaintEventArgs クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	ClipBounds	再描画が必要な DataGridView の領域を取得または設定します。
	ErrorText	現在の DataGridViewRow のエラーメッセージを表す文字列を取得します。
	Graphics	現在の DataGridViewRow の描画に使用される Graphics を取得します。
	Handled	イベントハンドラがイベントを完全に処理したかどうか、またはシステムが独自の処理を継続する必要があるかどうかを示す値を取得または設定します。(HandledEventArgs から継承されます。)
	InheritedRowStyle	行に適用されるセルスタイルを取得します。
	IsFirstDisplayedRow	現在の行が、DataGridView に現在表示されている最初の行かどうかを示す値を取得します。
	IsLastVisibleRow	現在の行が DataGridView に表示される最後の行かどうかを示す値を取得します。
	PaintParts	描画されるセル部分。
	RowBounds	現在の DataGridViewRow の境界を取得します。
	RowIndex	現在の DataGridViewRow のインデックスを取得します。
	State	現在の DataGridViewRow の状態を取得します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	DrawFocus	指定した境界の周囲にフォーカスを表す四角形を描画します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	PaintCells	指定した境界内の領域に対応する指定したセルの部分を描画します。
	PaintCellsBackground	指定した境界内の領域に対応するセルの背景を描画します。
	PaintCellsContent	指定した境界内の領域に対応するセルの内容を描画します。
	PaintHeader	オーバーロードされます。現在の行の行ヘッダーを描画します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

DataGridViewRowPrePaintEventArgsとは？わかりやすく解説

DataGridViewRowPrePaintEventArgs クラス

DataGridViewRowPrePaintEventArgs コンストラクタ

DataGridViewRowPrePaintEventArgs プロパティ

関連項目

DataGridViewRowPrePaintEventArgs メソッド

関連項目

DataGridViewRowPrePaintEventArgs メンバ

関連項目

「DataGridViewRowPrePaintEventArgs」の関連用語


	© 2025 Microsoft.All rights reserved.

DataGridViewRowPrePaintEventArgsとは？ わかりやすく解説

DataGridViewRowPrePaintEventArgs クラス

DataGridViewRowPrePaintEventArgs コンストラクタ

DataGridViewRowPrePaintEventArgs プロパティ

関連項目

DataGridViewRowPrePaintEventArgs メソッド

関連項目

DataGridViewRowPrePaintEventArgs メンバ

関連項目

急上昇のことば

「DataGridViewRowPrePaintEventArgs」の関連用語

DataGridViewRowPrePaintEventArgsとは？わかりやすく解説