DataGridViewCellPaintingEventArgs クラスとは何？わかりやすく解説 Weblio辞書

.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

public class DataGridViewCellPaintingEventArgs
 : HandledEventArgs

C++

public ref class DataGridViewCellPaintingEventArgs
 : public HandledEventArgs

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

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