DataGridViewRowPrePaintEventArgs Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menyediakan data untuk peristiwa tersebut RowPrePaint .

public ref class DataGridViewRowPrePaintEventArgs : System::ComponentModel::HandledEventArgs

public class DataGridViewRowPrePaintEventArgs : System.ComponentModel.HandledEventArgs

type DataGridViewRowPrePaintEventArgs = class
    inherit HandledEventArgs

Public Class DataGridViewRowPrePaintEventArgs
Inherits HandledEventArgs

Warisan

Object

EventArgs

HandledEventArgs

DataGridViewRowPrePaintEventArgs

Contoh

Contoh kode berikut menunjukkan cara menangani RowPrePaint peristiwa untuk menggambar latar belakang kustom untuk sel yang dipilih. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan dalam Cara: Menyesuaikan Tampilan Baris di Formulir Windows DataGridView Control.

// 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

Keterangan

Peristiwa RowPrePaint terjadi sebelum baris dicat pada DataGridView kontrol. RowPrePaint memungkinkan Anda menyesuaikan tampilan baris secara manual sebelum salah satu sel dalam baris dicat. Ini berguna jika Anda ingin mengkustomisasi baris, seperti untuk menghasilkan baris di mana konten satu kolom mencakup beberapa kolom. Gunakan properti di DataGridViewRowPrePaintEventArgs untuk mendapatkan pengaturan baris tanpa langsung mengakses baris di DataGridView.

Konstruktor

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

Menginisialisasi instans baru kelas DataGridViewRowPrePaintEventArgs.

Properti

ClipBounds	Mendapatkan atau mengatur area DataGridView yang perlu dicat ulang.
ErrorText	Mendapatkan string yang mewakili pesan kesalahan untuk saat ini DataGridViewRow.
Graphics	Mendapatkan yang Graphics digunakan untuk melukis arus DataGridViewRow.
Handled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah penanganan aktivitas telah sepenuhnya menangani peristiwa atau apakah sistem harus melanjutkan pemrosesannya sendiri. (Diperoleh dari HandledEventArgs)
InheritedRowStyle	Mendapatkan gaya sel yang diterapkan ke baris.
IsFirstDisplayedRow	Mendapatkan nilai yang menunjukkan apakah baris saat ini adalah baris pertama yang saat ini ditampilkan di DataGridView.
IsLastVisibleRow	Mendapatkan nilai yang menunjukkan apakah baris saat ini adalah baris terakhir yang terlihat di DataGridView.
PaintParts	Bagian sel yang akan dicat.
RowBounds	Dapatkan batasan dari saat ini DataGridViewRow.
RowIndex	Mendapatkan indeks dari saat ini DataGridViewRow.
State	Mendapatkan status saat ini DataGridViewRow.

Metode

DrawFocus(Rectangle, Boolean)	Menggambar persegi panjang fokus di sekitar batas yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
PaintCells(Rectangle, DataGridViewPaintParts)	Mengecat bagian sel yang ditentukan untuk area dalam batas yang ditentukan.
PaintCellsBackground(Rectangle, Boolean)	Mengecat latar belakang sel untuk area dalam batas yang ditentukan.
PaintCellsContent(Rectangle)	Mengecat isi sel untuk area dalam batas yang ditentukan.
PaintHeader(Boolean)	Mengecat seluruh header baris dari saat ini DataGridViewRow.
PaintHeader(DataGridViewPaintParts)	Mengecat bagian yang ditentukan dari header baris dari baris saat ini.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• DataGridView
• RowPrePaint