DataGridViewCellPaintingEventArgs Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
CellPainting olayı için veriler sağlar.
public ref class DataGridViewCellPaintingEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewCellPaintingEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewCellPaintingEventArgs = class
inherit HandledEventArgs
Public Class DataGridViewCellPaintingEventArgs
Inherits HandledEventArgs
- Devralma
Örnekler
Aşağıdaki kod örneği, bu türün kullanımını gösterir. Daha fazla bilgi için bkz. Nasıl yapılır: Windows Forms DataGridView Denetiminde Hücrelerin Görünümünü Özelleştirme.
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
OlayCellPainting, üzerinde DataGridViewgörünen her DataGridViewCell biri için oluşturulur. Performansı artırmak için içindeki bir hücreye doğrudan erişmek yerine hücrenin görünümünü değiştirmek için içindeki DataGridViewözellikleri DataGridViewCellPaintingEventArgs ayarlayın. Hücreyi el ile boyarsanız, özelliğini olarak true
ayarlayınHandledEventArgs.Handled. olarak ayarlamazsanız HandledEventArgs.Handledtrue
, hücre özelleştirmelerinizin üzerine boyanacaktır.
Oluşturucular
Özellikler
AdvancedBorderStyle |
Geçerli DataGridViewCellöğesinin kenarlık stilini alır. |
CellBounds |
Geçerli DataGridViewCellöğesinin sınırlarını alır. |
CellStyle |
Geçerli DataGridViewCellöğesinin hücre stilini alır. |
ClipBounds |
Öğesinin yeniden boyanması DataGridView gereken alanını alır. |
ColumnIndex |
Geçerli DataGridViewCellöğesinin sütun dizinini alır. |
ErrorText |
Geçerli DataGridViewCelliçin hata iletisini temsil eden bir dize alır. |
FormattedValue |
Geçerli DataGridViewCelldeğerinin biçimlendirilmiş değerini alır. |
Graphics |
Geçerli DataGridViewCellöğesini Graphics boyamak için kullanılan öğesini alır. |
Handled |
Olay işleyicisinin olayı tamamen işleyip işlemediğini veya sistemin kendi işlemeye devam edip etmeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: HandledEventArgs) |
PaintParts |
Boyanacak hücre parçaları. |
RowIndex |
Geçerli DataGridViewCellöğesinin satır dizinini alır. |
State |
Geçerli DataGridViewCelldurumunu alır. |
Value |
Geçerli DataGridViewCelldeğerini alır. |
Yöntemler
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
Paint(Rectangle, DataGridViewPaintParts) |
Belirtilen sınırlardaki alan için hücrenin belirtilen bölümlerini boyar. |
PaintBackground(Rectangle, Boolean) |
Belirtilen sınırlardaki alanın hücre arka planını boyar. |
PaintContent(Rectangle) |
Belirtilen sınırlardaki alanın hücre içeriğini boyar. |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |