DataGridView.CellPainting Ereignis
Definition
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.
Tritt auf, wenn eine Zelle gezeichnet werden muss.
public:
event System::Windows::Forms::DataGridViewCellPaintingEventHandler ^ CellPainting;public event System.Windows.Forms.DataGridViewCellPaintingEventHandler CellPainting;member this.CellPainting : System.Windows.Forms.DataGridViewCellPaintingEventHandler Public Custom Event CellPainting As DataGridViewCellPaintingEventHandler Ereignistyp
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie dieses Ereignis verwenden, um die Darstellung aller Zellen in einer bestimmten Spalte anzupassen.
Dieser Code ist Teil eines größeren Beispiels, das in 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
Hinweise
Sie können dieses Ereignis behandeln, um die Darstellung von Zellen im Steuerelement anzupassen. Sie können ganze Zellen selbst zeichnen oder bestimmte Teile von Zellen zeichnen und die DataGridViewCellPaintingEventArgs.PaintBackground methoden DataGridViewCellPaintingEventArgs.PaintContent verwenden, um andere Teile zu zeichnen. Sie können die Klasse auch verwenden, um Standardsteuerelemente VisualStyleRenderer mithilfe des aktuellen Designs zu zeichnen. Weitere Informationen finden Sie unter Renderingsteuerelemente mit visuellen Formatvorlagen. Wenn Sie Visual Studio 2005 verwenden, haben Sie auch Zugriff auf eine große Bibliothek von Standardbildern, die Sie mit dem DataGridView Steuerelement verwenden können.
Bei der Behandlung dieses Ereignisses sollten Sie über die Parameter des Ereignishandlers auf die Zelle zugreifen, anstatt direkt auf die Zelle zuzugreifen.
Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.