DataGridViewCellPaintingEventArgs クラス

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

DataGridViewCellPaintingEventArgs クラス

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

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

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

Visual Basic (宣言)

Public Class DataGridViewCellPaintingEventArgs
    Inherits HandledEventArgs

Visual Basic (使用法)

Dim instance As DataGridViewCellPaintingEventArgs

C#

public class DataGridViewCellPaintingEventArgs
 : HandledEventArgs

C++

public ref class DataGridViewCellPaintingEventArgs
 : public HandledEventArgs

J#

public class DataGridViewCellPaintingEventArgs
 extends HandledEventArgs

JScript

public class DataGridViewCellPaintingEventArgs
 extends HandledEventArgs

解説

CellPainting イベントは、DataGridView 上に表示される各 DataGridViewCell に対して発生します。パフォーマンスを向上するには、DataGridView のセルに直接アクセスする代わりに、DataGridViewCellPaintingEventArgs のプロパティを設定してセルの外観を変更します。手動でセルを描画するには、HandledEventArgs.Handled プロパティを true に設定します。HandledEventArgs.Handled を true に設定しないと、セルをカスタマイズした内容が上書き描画されます。

使用例

この型の使用方法を次のコード例に示します。詳細については、「方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする」を参照してください。

Visual Basic

Private Sub dataGridView1_CellPainting(ByVal
 sender As Object, _
    ByVal e As System.Windows.Forms.DataGridViewCellPaintingEventArgs)
 _
    Handles dataGridView1.CellPainting

    If Me.dataGridView1.Columns("ContactName").Index
 = _
        e.ColumnIndex AndAlso e.RowIndex >= 0 Then

        Dim newRect As New
 Rectangle(e.CellBounds.X + 1, e.CellBounds.Y + 1, _
            e.CellBounds.Width - 4, e.CellBounds.Height - 4)
        Dim backColorBrush As New
 SolidBrush(e.CellStyle.BackColor)
        Dim gridBrush As New
 SolidBrush(Me.dataGridView1.GridColor)
        Dim gridLinePen As New
 Pen(gridBrush)

        Try

            ' Erase the cell.
            e.Graphics.FillRectangle(backColorBrush, e.CellBounds)

            ' Draw the grid lines (only the right and bottom lines;
            ' DataGridView takes care of the others).
            e.Graphics.DrawLine(gridLinePen, e.CellBounds.Left, _
                e.CellBounds.Bottom - 1, e.CellBounds.Right - 1, _
                e.CellBounds.Bottom - 1)
            e.Graphics.DrawLine(gridLinePen, e.CellBounds.Right - 1, _
                e.CellBounds.Top, e.CellBounds.Right - 1, _
                e.CellBounds.Bottom)

            ' Draw the inset highlight box.
            e.Graphics.DrawRectangle(Pens.Blue, newRect)

            ' Draw the text content of the cell, ignoring alignment.
            If Not (e.Value Is
 Nothing) Then
                e.Graphics.DrawString(CStr(e.Value), e.CellStyle.Font, _
                Brushes.Crimson, e.CellBounds.X + 2, e.CellBounds.Y + 2, _
                StringFormat.GenericDefault)
            End If
            e.Handled = True

        Finally
            gridLinePen.Dispose()
            gridBrush.Dispose()
            backColorBrush.Dispose()
        End Try

    End If

End Sub

C#

private void dataGridView1_CellPainting(object
 sender,
System.Windows.Forms.DataGridViewCellPaintingEventArgs e)
{
    if (this.dataGridView1.Columns["ContactName"].Index
 ==
        e.ColumnIndex && e.RowIndex >= 0)
    {
        Rectangle newRect = new Rectangle(e.CellBounds.X + 1,
            e.CellBounds.Y + 1, e.CellBounds.Width - 4,
            e.CellBounds.Height - 4);

        using (
            Brush gridBrush = new SolidBrush(this.dataGridView1.GridColor)
,
            backColorBrush = new SolidBrush(e.CellStyle.BackColor))
        {
            using (Pen gridLinePen = new Pen(gridBrush))
            {
                // Erase the cell.
                e.Graphics.FillRectangle(backColorBrush, e.CellBounds);

                // Draw the grid lines (only the right and bottom lines;
                // DataGridView takes care of the others).
                e.Graphics.DrawLine(gridLinePen, e.CellBounds.Left,
                    e.CellBounds.Bottom - 1, e.CellBounds.Right - 1,
                    e.CellBounds.Bottom - 1);
                e.Graphics.DrawLine(gridLinePen, e.CellBounds.Right - 1,
                    e.CellBounds.Top, e.CellBounds.Right - 1,
                    e.CellBounds.Bottom);

                // Draw the inset highlight box.
                e.Graphics.DrawRectangle(Pens.Blue, newRect);

                // Draw the text content of the cell, ignoring alignment.
                if (e.Value != null)
                {
                    e.Graphics.DrawString((String)e.Value, e.CellStyle.Font,
                        Brushes.Crimson, e.CellBounds.X + 2,
                        e.CellBounds.Y + 2, StringFormat.GenericDefault);
                }
                e.Handled = true;
            }
        }
    }
}

継承階層

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

スレッド セーフ

この型の 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

参照

関連項目
DataGridViewCellPaintingEventArgs メンバ
System.Windows.Forms 名前空間
DataGridView.CellPainting イベント
DataGridViewCell クラス
DataGridView クラス