DataGridViewRowPrePaintEventHandler 代理人

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

DataGridViewEventHandlers.cs

代表將處理 RowPrePaint 之 DataGridView 事件的方法。

C#

public delegate void DataGridViewRowPrePaintEventHandler(object? sender, DataGridViewRowPrePaintEventArgs e);

參數

sender

Object

事件的來源。

e

DataGridViewRowPrePaintEventArgs

DataGridViewRowPrePaintEventArgs，其中包含事件資料。

範例

下列程式碼範例會顯示 DataGridViewRowPrePaintEventHandler 委派，如果選取資料列，則會繪製漸層資料列背景。 此程式碼範例是如何：自訂 DataGridView 控制項中 Windows Forms資料列外觀中提供之較大範例的一部分。

C#

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

備註

建立 DataGridViewRowPrePaintEventHandler 委派時，必須識別處理事件的方法。 若要使事件與您的事件處理常式產生關聯，請將委派的執行個體 (Instance) 加入至事件。 除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。 如需事件處理常式委派的詳細資訊，請參閱 處理和引發事件。

擴充方法

適用於

另請參閱

• DataGridView
• RowPrePaint
• 作法：自訂 Windows Forms DataGridView 控制項的資料列外觀