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);
        }
    }
}