DataGridViewRowPrePaintEventArgs Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

RowPrePaint olayı için veriler sağlar.

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

public class DataGridViewRowPrePaintEventArgs : System.ComponentModel.HandledEventArgs

type DataGridViewRowPrePaintEventArgs = class
    inherit HandledEventArgs

Public Class DataGridViewRowPrePaintEventArgs
Inherits HandledEventArgs

Devralma

Object

EventArgs

HandledEventArgs

DataGridViewRowPrePaintEventArgs

Örnekler

Aşağıdaki kod örneği, seçilen hücreler için özel bir arka plan çizmek üzere olayın nasıl işlenmek RowPrePaint üzere yapıldığını gösterir. Bu kod örneği, Nasıl yapılır: Windows Forms DataGridView Denetimindeki Satırların Görünümünü Özelleştirme bölümünde sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Olay, RowPrePaint bir satır denetime DataGridView boyanmadan önce gerçekleşir. RowPrePaint satırdaki hücrelerden herhangi biri boyanmadan önce satırın görünümünü el ile ayarlamanıza olanak tanır. Bu, bir sütunun içeriğinin birden çok sütuna yayıldığı bir satır oluşturmak gibi bir satırı özelleştirmek istediğinizde kullanışlıdır. içindeki satıra doğrudan erişmeden satırın ayarlarını almak için içindeki DataGridViewözelliklerini DataGridViewRowPrePaintEventArgs kullanın.

Oluşturucular

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

DataGridViewRowPrePaintEventArgs sınıfının yeni bir örneğini başlatır.

Özellikler

ClipBounds	öğesinin yeniden boyanması DataGridView gereken alanını alır veya ayarlar.
ErrorText	Geçerli DataGridViewRowiçin hata iletisini temsil eden bir dize alır.
Graphics	Geçerli DataGridViewRowöğesini Graphics boyamak için kullanılan öğesini alır.
Handled	Olay işleyicisinin olayı tamamen işleyip işlemediğini veya sistemin kendi işlemeye devam edip etmeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: HandledEventArgs)
InheritedRowStyle	Satıra uygulanan hücre stilini alır.
IsFirstDisplayedRow	Geçerli satırın şu anda içinde DataGridViewgörüntülenen ilk satır olup olmadığını belirten bir değer alır.
IsLastVisibleRow	Geçerli satırın içindeki son görünür satır DataGridViewolup olmadığını belirten bir değer alır.
PaintParts	Boyanacak hücre parçaları.
RowBounds	Geçerli DataGridViewRowöğesinin sınırlarını alır.
RowIndex	Geçerli DataGridViewRowdizinini alır.
State	Geçerli DataGridViewRowdurumunu alır.

Yöntemler

DrawFocus(Rectangle, Boolean)	Odak dikdörtgenini belirtilen sınırların etrafına çizer.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
PaintCells(Rectangle, DataGridViewPaintParts)	Belirtilen sınırlardaki alan için belirtilen hücre parçalarını boyar.
PaintCellsBackground(Rectangle, Boolean)	Belirtilen sınırlardaki alanın hücre arka planlarını boyar.
PaintCellsContent(Rectangle)	Belirtilen sınırlardaki alanın hücre içeriğini boyar.
PaintHeader(Boolean)	Geçerli DataGridViewRowöğesinin tüm satır üst bilgisini boyar.
PaintHeader(DataGridViewPaintParts)	Geçerli satırın satır üst bilgisinin belirtilen bölümlerini boyar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• DataGridView
• RowPrePaint