DataGridViewRowPostPaintEventArgs Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Daten für das RowPostPaint-Ereignis bereit.

public ref class DataGridViewRowPostPaintEventArgs : EventArgs

public class DataGridViewRowPostPaintEventArgs : EventArgs

type DataGridViewRowPostPaintEventArgs = class
    inherit EventArgs

Public Class DataGridViewRowPostPaintEventArgs
Inherits EventArgs

Vererbung: Object

EventArgs
DataGridViewRowPostPaintEventArgs

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das RowPostPaint Ereignis behandelt wird, damit sich der Inhalt einer Zelle über die gesamte Zeile erstreckt. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels unter Vorgehensweise: Anpassen der Darstellung von Zeilen im Windows Forms DataGridView-Steuerelement.

// Paints the content that spans multiple columns and the focus rectangle.
void dataGridView1_RowPostPaint(object sender,
    DataGridViewRowPostPaintEventArgs e)
{
    // 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);

    SolidBrush forebrush = null;
    try
    {
        // Determine the foreground color.
        if ((e.State & DataGridViewElementStates.Selected) ==
            DataGridViewElementStates.Selected)
        {
            forebrush = new SolidBrush(e.InheritedRowStyle.SelectionForeColor);
        }
        else
        {
            forebrush = new SolidBrush(e.InheritedRowStyle.ForeColor);
        }

        // Get the content that spans multiple columns.
        object recipe =
            this.dataGridView1.Rows.SharedRow(e.RowIndex).Cells[2].Value;

        if (recipe != null)
        {
            String text = recipe.ToString();

            // Calculate the bounds for the content that spans multiple 
            // columns, adjusting for the horizontal scrolling position 
            // and the current row height, and displaying only whole
            // lines of text.
            Rectangle textArea = rowBounds;
            textArea.X -= this.dataGridView1.HorizontalScrollingOffset;
            textArea.Width += this.dataGridView1.HorizontalScrollingOffset;
            textArea.Y += rowBounds.Height - e.InheritedRowStyle.Padding.Bottom;
            textArea.Height -= rowBounds.Height -
                e.InheritedRowStyle.Padding.Bottom;
            textArea.Height = (textArea.Height / e.InheritedRowStyle.Font.Height) *
                e.InheritedRowStyle.Font.Height;

            // Calculate the portion of the text area that needs painting.
            RectangleF clip = textArea;
            clip.Width -= this.dataGridView1.RowHeadersWidth + 1 - clip.X;
            clip.X = this.dataGridView1.RowHeadersWidth + 1;
            RectangleF oldClip = e.Graphics.ClipBounds;
            e.Graphics.SetClip(clip);

            // Draw the content that spans multiple columns.
            e.Graphics.DrawString(
                text, e.InheritedRowStyle.Font, forebrush, textArea);

            e.Graphics.SetClip(oldClip);
        }
    }
    finally
    {
        forebrush.Dispose();
    }

    if (this.dataGridView1.CurrentCellAddress.Y == e.RowIndex)
    {
        // Paint the focus rectangle.
        e.DrawFocus(rowBounds, true);
    }
}

' Paints the content that spans multiple columns and the focus rectangle.
Sub dataGridView1_RowPostPaint(ByVal sender As Object, _
    ByVal e As DataGridViewRowPostPaintEventArgs) _
    Handles dataGridView1.RowPostPaint

    ' 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)

    Dim forebrush As SolidBrush = Nothing
    Try
        ' Determine the foreground color.
        If (e.State And DataGridViewElementStates.Selected) = _
            DataGridViewElementStates.Selected Then

            forebrush = New SolidBrush(e.InheritedRowStyle.SelectionForeColor)
        Else
            forebrush = New SolidBrush(e.InheritedRowStyle.ForeColor)
        End If

        ' Get the content that spans multiple columns.
        Dim recipe As Object = _
            Me.dataGridView1.Rows.SharedRow(e.RowIndex).Cells(2).Value

        If (recipe IsNot Nothing) Then
            Dim text As String = recipe.ToString()

            ' Calculate the bounds for the content that spans multiple 
            ' columns, adjusting for the horizontal scrolling position 
            ' and the current row height, and displaying only whole
            ' lines of text.
            Dim textArea As Rectangle = rowBounds
            textArea.X -= Me.dataGridView1.HorizontalScrollingOffset
            textArea.Width += Me.dataGridView1.HorizontalScrollingOffset
            textArea.Y += rowBounds.Height - e.InheritedRowStyle.Padding.Bottom
            textArea.Height -= rowBounds.Height - e.InheritedRowStyle.Padding.Bottom
            textArea.Height = (textArea.Height \ e.InheritedRowStyle.Font.Height) * _
                e.InheritedRowStyle.Font.Height

            ' Calculate the portion of the text area that needs painting.
            Dim clip As RectangleF = textArea
            clip.Width -= Me.dataGridView1.RowHeadersWidth + 1 - clip.X
            clip.X = Me.dataGridView1.RowHeadersWidth + 1
            Dim oldClip As RectangleF = e.Graphics.ClipBounds
            e.Graphics.SetClip(clip)

            ' Draw the content that spans multiple columns.
            e.Graphics.DrawString(text, e.InheritedRowStyle.Font, forebrush, _
                textArea)

            e.Graphics.SetClip(oldClip)
        End If
    Finally
        forebrush.Dispose()
    End Try

    If Me.dataGridView1.CurrentCellAddress.Y = e.RowIndex Then
        ' Paint the focus rectangle.
        e.DrawFocus(rowBounds, True)
    End If

End Sub

Hinweise

Das RowPostPaint Ereignis tritt auf, nachdem eine Zeile in einem DataGridView Steuerelement gezeichnet wurde. RowPostPaint ermöglicht es Ihnen, das Erscheinungsbild der Zeile manuell anzupassen, nachdem die Zellen in der Zeile gezeichnet wurden. Dies ist nützlich, wenn Sie die Zeile anpassen möchten.

Konstruktoren

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

Initialisiert eine neue Instanz der DataGridViewRowPostPaintEventArgs-Klasse.

Eigenschaften

ClipBounds	Ruft die Fläche der DataGridView ab, die neu zu zeichnen ist, oder legt diese fest.
ErrorText	Ruft eine Zeichenfolge ab, die eine Fehlermeldung für die aktuelle DataGridViewRow darstellt.
Graphics	Ruft die Graphics ab, mit der die aktuelle DataGridViewRow gezeichnet wird.
InheritedRowStyle	Ruft den Zellstil ab, der auf die aktuelle DataGridViewRow angewendet wurde.
IsFirstDisplayedRow	Ruft einen Wert ab, der angibt, ob die aktuelle Zeile die erste in der DataGridView angezeigte Zeile ist.
IsLastVisibleRow	Ruft einen Wert ab, der angibt, ob die aktuelle Zeile die letzte sichtbare Zeile ist, die in der DataGridView angezeigt wird.
RowBounds	Ruft die Grenzen der aktuellen DataGridViewRow ab.
RowIndex	Ruft den Index der aktuellen DataGridViewRow ab.
State	Ruft den Zustand der aktuellen DataGridViewRow ab.

Methoden

DrawFocus(Rectangle, Boolean)	Zeichnet das Fokusrechteck um die angegebenen Grenzen.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
PaintCells(Rectangle, DataGridViewPaintParts)	Zeichnet, die angegebenen Zellteile für den Bereich in den angegebenen Grenzen.
PaintCellsBackground(Rectangle, Boolean)	Zeichnet die Zellhintergründe für den Bereich in den angegebenen Grenzen.
PaintCellsContent(Rectangle)	Zeichnet den Zellinhalt für den Bereich in den angegebenen Grenzen.
PaintHeader(Boolean)	Zeichnet den gesamten Zeilenheader der aktuellen DataGridViewRow.
PaintHeader(DataGridViewPaintParts)	Zeichnet die angegebenen Teile des Zeilenheaders der aktuellen Zeile.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für: