DataGridViewRowPrePaintEventArgs 類別

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

DataGridViewRowPrePaintEventArgs.cs

提供 RowPrePaint 事件的資料。

C#

public class DataGridViewRowPrePaintEventArgs : System.ComponentModel.HandledEventArgs

繼承

Object

EventArgs

HandledEventArgs

DataGridViewRowPrePaintEventArgs

範例

下列程式碼範例示範如何處理 RowPrePaint 事件，以繪製所選儲存格的自訂背景。 此程式碼範例是How to： Customize the Appearance of Rows in the Windows Forms DataGridView Control中所提供的較大範例的一部分。

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

備註

此 RowPrePaint 事件會在在控制項上 DataGridView 繪製資料列之前發生。 RowPrePaint 可讓您在繪製資料列中的任何儲存格之前，手動調整資料列的外觀。 如果您想要自訂資料列，例如產生一個資料行內容跨越多個資料行的資料列，這會很有用。 使用 中的 DataGridViewRowPrePaintEventArgs 屬性來取得資料列的設定，而不需要直接存取 中的資料 DataGridView 列。

建構函式

DataGridViewRowPrePaintEventArgs(DataGridView, Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, String, DataGridViewCellStyle, Boolean, Boolean)

初始化 DataGridViewRowPrePaintEventArgs 類別的新執行個體。

屬性

ClipBounds	取得或設定需要重新繪製的 DataGridView 區域。
ErrorText	取得字串，表示目前 DataGridViewRow 的錯誤訊息。
Graphics	取得用來繪製目前 Graphics 的 DataGridViewRow。
InheritedRowStyle	取得套用至資料列的儲存格樣式。
IsFirstDisplayedRow	取得值，指出目前的資料列是否為 DataGridView 中所顯示的第一個資料列。
IsLastVisibleRow	取得值，指出目前的資料列是否為 DataGridView 中最後一個可見資料列。
PaintParts	要繪製的儲存格部分。
RowBounds	取得目前 DataGridViewRow 的界限。
RowIndex	取得目前 DataGridViewRow 的索引。
State	取得目前 DataGridViewRow 的狀態。

方法

DrawFocus(Rectangle, Boolean)	在指定的界限四周繪製焦點矩形。
PaintCells(Rectangle, DataGridViewPaintParts)	繪製所指定界限內區域之指定的儲存格部分。
PaintCellsBackground(Rectangle, Boolean)	繪製所指定界限內區域的儲存格背景。
PaintCellsContent(Rectangle)	繪製所指定界限內區域的儲存格內容。
PaintHeader(Boolean)	繪製目前 DataGridViewRow 的整個資料列行首。
PaintHeader(DataGridViewPaintParts)	繪製目前資料列之資料列行首所指定的部分。

適用於

另請參閱

• DataGridView
• RowPrePaint