DataGridView.RowPrePaint 事件

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

在绘制 DataGridViewRow 前发生。

public:
 event System::Windows::Forms::DataGridViewRowPrePaintEventHandler ^ RowPrePaint;

public event System.Windows.Forms.DataGridViewRowPrePaintEventHandler RowPrePaint;

member this.RowPrePaint : System.Windows.Forms.DataGridViewRowPrePaintEventHandler 

Public Custom Event RowPrePaint As DataGridViewRowPrePaintEventHandler 

事件类型

DataGridViewRowPrePaintEventHandler

示例

下面的代码示例演示如何使用 事件的处理程序来 RowPrePaint 绘制渐变行背景（如果选择了该行）。 此示例是如何：自定义 DataGridView 控件中行的外观中提供的更大示例的 Windows 窗体一部分。

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

' 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

注解

可以单独处理此事件，也可以与 RowPostPaint 事件结合使用，以自定义控件中行的外观。 可以自己绘制整行，也可以绘制行的特定部分，并使用 类的 DataGridViewRowPrePaintEventArgs 以下方法来绘制其他部分：

• DrawFocus

• PaintCells

• PaintCellsBackground

• PaintCellsContent

• PaintHeader

还可以使用 VisualStyleRenderer 类使用当前主题绘制标准控件。 有关详细信息，请参阅使用视觉样式呈现控件。 如果使用 Visual Studio 2005，还可以访问可与 控件一起使用 DataGridView 的大型标准图像库。

有关如何处理事件的详细信息，请参阅 处理和引发事件。

另请参阅

• DataGridView 控件（Windows 窗体）