DataGridViewCellPaintingEventArgs Klas

Definitie

Biedt gegevens voor de CellPainting gebeurtenis.

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

Voorbeelden

Het volgende codevoorbeeld illustreert het gebruik van dit type. Zie Procedure: Het uiterlijk van cellen aanpassen in het Besturingselement Windows Forms DataGridViewvoor meer informatie.

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

Opmerkingen

De CellPainting gebeurtenis wordt gegenereerd voor elke DataGridViewCell gebeurtenis die zichtbaar is op een DataGridView. Als u de prestaties wilt verbeteren, stelt u de eigenschappen in een DataGridViewCellPaintingEventArgs in om het uiterlijk van de cel te wijzigen in plaats van rechtstreeks toegang te krijgen tot een cel in de DataGridViewcel. Als u de cel handmatig schildert, stelt u de HandledEventArgs.Handled eigenschap in op true. Als u dit niet instelt HandledEventArgs.Handledtrue, wordt de cel over uw aanpassingen geschilderd.

Constructors

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

Initialiseert een nieuw exemplaar van de DataGridViewCellPaintingEventArgs klasse.

Eigenschappen

Name Description
AdvancedBorderStyle

Hiermee haalt u de randstijl van de huidige DataGridViewCellop.

CellBounds

Haal de grenzen van de huidige DataGridViewCell.

CellStyle

Hiermee haalt u de celstijl van de huidige DataGridViewCellop.

ClipBounds

Hiermee haalt u het gebied op dat DataGridView moet worden geschilderd.

ColumnIndex

Hiermee haalt u de kolomindex van de huidige DataGridViewCellop.

ErrorText

Hiermee haalt u een tekenreeks op die een foutbericht voor de huidige DataGridViewCellvertegenwoordigt.

FormattedValue

Hiermee wordt de opgemaakte waarde van de huidige DataGridViewCellopgehaald.

Graphics

Hiermee wordt de Graphics opgegeven om de huidige DataGridViewCellte schilderen.

Handled

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebeurtenis-handler de gebeurtenis volledig heeft verwerkt of dat het systeem de eigen verwerking moet voortzetten.

(Overgenomen van HandledEventArgs)
PaintParts

De celdelen die moeten worden geschilderd.

RowIndex

Hiermee haalt u de rijindex van de huidige DataGridViewCellop.

State

Hiermee haalt u de status van de huidige DataGridViewCellop.

Value

Hiermee wordt de waarde van de huidige DataGridViewCellopgehaald.

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
Paint(Rectangle, DataGridViewPaintParts)

Verft de opgegeven delen van de cel voor het gebied in de opgegeven grenzen.

PaintBackground(Rectangle, Boolean)

Hiermee wordt de celachtergrond voor het gebied in de opgegeven grenzen weergegeven.

PaintContent(Rectangle)

Hiermee wordt de celinhoud voor het gebied in de opgegeven grenzen weergegeven.

ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook