DataGridViewRowPrePaintEventArgs Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGridViewRowPrePaintEventArgs.cs

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şleneceğini RowPrePaint gösterir. Bu kod örneği, Nasıl yapılır: Windows Forms DataGridView Denetiminde 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 denetimde DataGridView bir satır 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 özellikleri DataGridViewRowPrePaintEventArgs kullanarak içindeki satıra doğrudan erişmeden satırın DataGridViewayarlarını alın.

Oluşturucular

Name	Description
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

Name	Description
ClipBounds	Yeniden boyanması DataGridView gereken alanı alır veya ayarlar.
ErrorText	Geçerli DataGridViewRowiçin hata iletisini temsil eden bir dize alır.
Graphics	Graphics Geçerli DataGridViewRowöğesini boyamak için kullanılan öğesini alır.
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ı gösteren bir değer alır.
IsLastVisibleRow	Geçerli satırın içindeki son görünür satır DataGridViewolup olmadığını gösteren bir değer alır.
PaintParts	Boyanacak hücre parçaları.
RowBounds	Geçerli DataGridViewRowöğesinin sınırlarını alın.
RowIndex	Geçerli DataGridViewRowdizinini alır.
State	Geçerli DataGridViewRowdurumunu alır.

Yöntemler

Name	Description
DrawFocus(Rectangle, Boolean)	Odak dikdörtgenini belirtilen sınırların etrafına çizer.
PaintCells(Rectangle, DataGridViewPaintParts)	Belirtilen sınırlardaki alan için belirtilen hücre bölümlerini 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 DataGridViewRowsatırın üst bilgisinin tamamını boyar.
PaintHeader(DataGridViewPaintParts)	Geçerli satırın satır üst bilgisinin belirtilen bölümlerini boyar.

Ayrıca bkz.

• DataGridView
• RowPrePaint