DataGridViewCellPaintingEventArgs Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
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) |