DataGridViewCellPaintingEventArgs Sınıf

Tanım

CellPainting olayı için veriler sağlar.Provides data for the CellPainting event.

public ref class DataGridViewCellPaintingEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewCellPaintingEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewCellPaintingEventArgs = class
    inherit HandledEventArgs
Public Class DataGridViewCellPaintingEventArgs
Inherits HandledEventArgs
Devralma
DataGridViewCellPaintingEventArgs

Örnekler

Aşağıdaki kod örneği, bu türün kullanımını gösterir.The following code example illustrates the use of this type. Daha fazla bilgi için bkz. nasıl yapılır: Windows Forms DataGridView Denetimindeki hücrelerin görünümünü özelleştirme.For more information, see How to: Customize the Appearance of Cells in the Windows Forms DataGridView Control.

private void dataGridView1_CellPainting(object sender,
System.Windows.Forms.DataGridViewCellPaintingEventArgs e)
{
    if (this.dataGridView1.Columns["ContactName"].Index ==
        e.ColumnIndex && e.RowIndex >= 0)
    {
        Rectangle newRect = new Rectangle(e.CellBounds.X + 1,
            e.CellBounds.Y + 1, e.CellBounds.Width - 4,
            e.CellBounds.Height - 4);

        using (
            Brush gridBrush = new SolidBrush(this.dataGridView1.GridColor),
            backColorBrush = new SolidBrush(e.CellStyle.BackColor))
        {
            using (Pen gridLinePen = new Pen(gridBrush))
            {
                // Erase the cell.
                e.Graphics.FillRectangle(backColorBrush, e.CellBounds);

                // Draw the grid lines (only the right and bottom lines;
                // DataGridView takes care of the others).
                e.Graphics.DrawLine(gridLinePen, e.CellBounds.Left,
                    e.CellBounds.Bottom - 1, e.CellBounds.Right - 1,
                    e.CellBounds.Bottom - 1);
                e.Graphics.DrawLine(gridLinePen, e.CellBounds.Right - 1,
                    e.CellBounds.Top, e.CellBounds.Right - 1,
                    e.CellBounds.Bottom);

                // Draw the inset highlight box.
                e.Graphics.DrawRectangle(Pens.Blue, newRect);

                // Draw the text content of the cell, ignoring alignment.
                if (e.Value != null)
                {
                    e.Graphics.DrawString((String)e.Value, e.CellStyle.Font,
                        Brushes.Crimson, e.CellBounds.X + 2,
                        e.CellBounds.Y + 2, StringFormat.GenericDefault);
                }
                e.Handled = true;
            }
        }
    }
}
Private Sub dataGridView1_CellPainting(ByVal sender As Object, _
    ByVal e As System.Windows.Forms.DataGridViewCellPaintingEventArgs) _
    Handles dataGridView1.CellPainting

    If Me.dataGridView1.Columns("ContactName").Index = _
        e.ColumnIndex AndAlso e.RowIndex >= 0 Then

        Dim newRect As New Rectangle(e.CellBounds.X + 1, e.CellBounds.Y + 1, _
            e.CellBounds.Width - 4, e.CellBounds.Height - 4)
        Dim backColorBrush As New SolidBrush(e.CellStyle.BackColor)
        Dim gridBrush As New SolidBrush(Me.dataGridView1.GridColor)
        Dim gridLinePen As New Pen(gridBrush)

        Try

            ' Erase the cell.
            e.Graphics.FillRectangle(backColorBrush, e.CellBounds)

            ' Draw the grid lines (only the right and bottom lines;
            ' DataGridView takes care of the others).
            e.Graphics.DrawLine(gridLinePen, e.CellBounds.Left, _
                e.CellBounds.Bottom - 1, e.CellBounds.Right - 1, _
                e.CellBounds.Bottom - 1)
            e.Graphics.DrawLine(gridLinePen, e.CellBounds.Right - 1, _
                e.CellBounds.Top, e.CellBounds.Right - 1, _
                e.CellBounds.Bottom)

            ' Draw the inset highlight box.
            e.Graphics.DrawRectangle(Pens.Blue, newRect)

            ' Draw the text content of the cell, ignoring alignment.
            If (e.Value IsNot Nothing) Then
                e.Graphics.DrawString(CStr(e.Value), e.CellStyle.Font, _
                Brushes.Crimson, e.CellBounds.X + 2, e.CellBounds.Y + 2, _
                StringFormat.GenericDefault)
            End If
            e.Handled = True

        Finally
            gridLinePen.Dispose()
            gridBrush.Dispose()
            backColorBrush.Dispose()
        End Try

    End If

End Sub

Açıklamalar

CellPaintingOlay, bir üzerinde görünür her biri için oluşturulur DataGridViewCell DataGridView .The CellPainting event is raised for each DataGridViewCell that is visible on a DataGridView. Performansı artırmak için içindeki özellikleri DataGridViewCellPaintingEventArgs , içindeki bir hücreye doğrudan erişmek yerine hücrenin görünümünü değiştirmek için ayarlayın DataGridView .To improve performance, set the properties in a DataGridViewCellPaintingEventArgs to change the appearance of the cell instead of directly accessing a cell in the DataGridView. Hücreyi el ile boyadıysanız HandledEventArgs.Handled özelliğini olarak ayarlayın true .If you manually paint the cell, set the HandledEventArgs.Handled property to true. HandledEventArgs.HandledOlarak ayarlarsanız true , hücre özelleştirmelerinizin üzerine boyaacaktır.If you do not set HandledEventArgs.Handled to true, the cell will paint over your customizations.

Oluşturucular

DataGridViewCellPaintingEventArgs(DataGridView, Graphics, Rectangle, Rectangle, Int32, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

DataGridViewCellPaintingEventArgs sınıfının yeni bir örneğini başlatır.Initializes a new instance of the DataGridViewCellPaintingEventArgs class.

Özellikler

AdvancedBorderStyle

Geçerli öğesinin kenarlık stilini alır DataGridViewCell .Gets the border style of the current DataGridViewCell.

CellBounds

Geçerli alanının sınırlarını alın DataGridViewCell .Get the bounds of the current DataGridViewCell.

CellStyle

Geçerli öğesinin hücre stilini alır DataGridViewCell .Gets the cell style of the current DataGridViewCell.

ClipBounds

Yeniden DataGridView boyanması gereken öğesinin alanını alır.Gets the area of the DataGridView that needs to be repainted.

ColumnIndex

Geçerli öğesinin sütun dizinini alır DataGridViewCell .Gets the column index of the current DataGridViewCell.

ErrorText

Geçerli bir hata iletisini temsil eden bir dize alır DataGridViewCell .Gets a string that represents an error message for the current DataGridViewCell.

FormattedValue

Geçerli değerin biçimlendirilen değerini alır DataGridViewCell .Gets the formatted value of the current DataGridViewCell.

Graphics

Geçerli olduğunu Graphics boyamak için kullanılan öğesini alır DataGridViewCell .Gets the Graphics used to paint the current DataGridViewCell.

Handled

Olay işleyicisinin olayı tamamen işlemediğini veya sistemin kendi işleme devam edip etmediğini gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing.

(Devralındığı yer: HandledEventArgs)
PaintParts

Boyanmış olan hücre bölümleri.The cell parts that are to be painted.

RowIndex

Geçerli öğesinin satır dizinini alır DataGridViewCell .Gets the row index of the current DataGridViewCell.

State

Geçerli öğesinin durumunu alır DataGridViewCell .Gets the state of the current DataGridViewCell.

Value

Geçerli öğesinin değerini alır DataGridViewCell .Gets the value of the current DataGridViewCell.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
Paint(Rectangle, DataGridViewPaintParts)

Belirtilen sınırlar içindeki alan için hücrenin belirtilen bölümlerini boyar.Paints the specified parts of the cell for the area in the specified bounds.

PaintBackground(Rectangle, Boolean)

Belirtilen sınırdaki alan için hücre arka planını boyar.Paints the cell background for the area in the specified bounds.

PaintContent(Rectangle)

Belirtilen sınırdaki alana ait hücre içeriğini boyar.Paints the cell content for the area in the specified bounds.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.