DataGridViewCellPaintingEventArgs 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

DataGridViewCellPaintingEventArgs.cs

为 CellPainting 事件提供数据。

C#

public class DataGridViewCellPaintingEventArgs : System.ComponentModel.HandledEventArgs

继承

Object

EventArgs

HandledEventArgs

DataGridViewCellPaintingEventArgs

示例

下面的代码示例演示了此类型的用法。 有关详细信息，请参阅如何：自定义 Windows 窗体 DataGridView 控件中单元格的外观。

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

注解

对于 CellPainting 在 上DataGridView可见的每个 DataGridViewCell ，都会引发 事件。 若要提高性能，请在 中 DataGridViewCellPaintingEventArgs 设置 属性以更改单元格的外观，而不是直接访问 中的 DataGridView单元格。 如果手动绘制单元格，请将 HandledEventArgs.Handled 属性设置为 true。 如果未将 设置为 HandledEventArgs.Handledtrue，则单元格将在自定义项上绘制。

构造函数

DataGridViewCellPaintingEventArgs(DataGridView, Graphics, Rectangle, Rectangle, Int32, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

初始化 DataGridViewCellPaintingEventArgs 类的新实例。

属性

AdvancedBorderStyle	获取当前 DataGridViewCell 的边框样式。
CellBounds	获取当前 DataGridViewCell 的边界。
CellStyle	获取当前 DataGridViewCell 的单元格样式。
ClipBounds	获取 DataGridView 中需要重新绘制的区域。
ColumnIndex	获取当前 DataGridViewCell 的列索引。
ErrorText	获取表示当前 DataGridViewCell 的错误消息的字符串。
FormattedValue	获取当前 DataGridViewCell 的格式化值。
Graphics	获取用于绘制当前 Graphics 的 DataGridViewCell。
PaintParts	要绘制的单元格部分。
RowIndex	获取当前 DataGridViewCell 的行索引。
State	获取当前 DataGridViewCell 的状态。
Value	获取当前 DataGridViewCell 的值。

方法

Paint(Rectangle, DataGridViewPaintParts)	绘制指定边界中相应区域的单元格的指定部分。
PaintBackground(Rectangle, Boolean)	绘制指定边界中相应区域的单元格背景。
PaintContent(Rectangle)	绘制指定边界中相应区域的单元格内容。

适用于

另请参阅

• CellPainting
• DataGridViewCell
• DataGridView