DrawItemEventArgs 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.
DrawItem
olayı için veriler sağlar.
public ref class DrawItemEventArgs : EventArgs
public ref class DrawItemEventArgs : EventArgs, IDisposable, System::Drawing::IDeviceContext
public class DrawItemEventArgs : EventArgs
public class DrawItemEventArgs : EventArgs, IDisposable, System.Drawing.IDeviceContext
type DrawItemEventArgs = class
inherit EventArgs
type DrawItemEventArgs = class
inherit EventArgs
interface IDisposable
interface IDeviceContext
Public Class DrawItemEventArgs
Inherits EventArgs
Public Class DrawItemEventArgs
Inherits EventArgs
Implements IDeviceContext, IDisposable
- Devralma
- Türetilmiş
- Uygulamalar
Örnekler
Aşağıdaki örnekte sahip tarafından çizilmiş ListBox öğelerin nasıl oluşturulacağı gösterilmektedir. Kod, çizilen öğelerin sabit boyutlu olduğunu ve DrawItem her öğenin ListBoxiçine çizimini gerçekleştirme olayını belirtmek için özelliğini kullanırDrawMode. Örnek kod, öğeleri çizmek için olay işleyicisine parametre olarak geçirilen sınıfın özelliklerini ve yöntemlerini DrawItemEventArgs kullanır. Bu örnekte, adlı listBox1
bir ListBox denetimin forma eklendiği ve DrawItem olayın örnek kodda tanımlanan olay işleyicisi tarafından işlendiği varsayılır. Örnekte ayrıca öğeleri öğesine bu sırada "Apple", "Orange" ve "Plum" metinleriyle eklendiği ListBox varsayılır.
private ListBox ListBox1 = new ListBox();
private void InitializeListBox()
{
ListBox1.Items.AddRange(new Object[]
{ "Red Item", "Orange Item", "Purple Item" });
ListBox1.Location = new System.Drawing.Point(81, 69);
ListBox1.Size = new System.Drawing.Size(120, 95);
ListBox1.DrawMode = DrawMode.OwnerDrawFixed;
ListBox1.DrawItem += new DrawItemEventHandler(ListBox1_DrawItem);
Controls.Add(ListBox1);
}
private void ListBox1_DrawItem(object sender,
System.Windows.Forms.DrawItemEventArgs e)
{
// Draw the background of the ListBox control for each item.
e.DrawBackground();
// Define the default color of the brush as black.
Brush myBrush = Brushes.Black;
// Determine the color of the brush to draw each item based
// on the index of the item to draw.
switch (e.Index)
{
case 0:
myBrush = Brushes.Red;
break;
case 1:
myBrush = Brushes.Orange;
break;
case 2:
myBrush = Brushes.Purple;
break;
}
// Draw the current item text based on the current Font
// and the custom brush settings.
e.Graphics.DrawString(ListBox1.Items[e.Index].ToString(),
e.Font, myBrush, e.Bounds, StringFormat.GenericDefault);
// If the ListBox has focus, draw a focus rectangle around the selected item.
e.DrawFocusRectangle();
}
Private WithEvents ListBox1 As New ListBox()
Private Sub InitializeListBox()
ListBox1.Items.AddRange(New Object() _
{"Red Item", "Orange Item", "Purple Item"})
ListBox1.Location = New System.Drawing.Point(81, 69)
ListBox1.Size = New System.Drawing.Size(120, 95)
ListBox1.DrawMode = DrawMode.OwnerDrawFixed
Controls.Add(ListBox1)
End Sub
Private Sub ListBox1_DrawItem(ByVal sender As Object, _
ByVal e As System.Windows.Forms.DrawItemEventArgs) _
Handles ListBox1.DrawItem
' Draw the background of the ListBox control for each item.
e.DrawBackground()
' Define the default color of the brush as black.
Dim myBrush As Brush = Brushes.Black
' Determine the color of the brush to draw each item based on
' the index of the item to draw.
Select Case e.Index
Case 0
myBrush = Brushes.Red
Case 1
myBrush = Brushes.Orange
Case 2
myBrush = Brushes.Purple
End Select
' Draw the current item text based on the current
' Font and the custom brush settings.
e.Graphics.DrawString(ListBox1.Items(e.Index).ToString(), _
e.Font, myBrush, e.Bounds, StringFormat.GenericDefault)
' If the ListBox has focus, draw a focus rectangle around _
' the selected item.
e.DrawFocusRectangle()
End Sub
Açıklamalar
OlayDrawItem
, ve ComboBox denetimleri gibi ListBox sahip çizim denetimleri tarafından oluşturulur. Kullanıcının belirtilen öğeyi boyaması için gereken öğe dizinini, çizimin Rectangleyapılması gereken öğesini ve Graphics öğesini içeren tüm bilgileri içerir.
Oluşturucular
DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState) |
Belirtilen denetim için sınıfın DrawItemEventArgs yeni bir örneğini belirtilen yazı tipi, durum, çizecek yüzey ve içinde çizecek sınırlar ile başlatır. |
DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, Color, Color) |
Belirtilen denetim için sınıfın DrawItemEventArgs yeni bir örneğini belirtilen yazı tipi, durum, ön plan rengi, arka plan rengi, çizecek yüzey ve içinde çizecek sınırlar ile başlatır. |
Özellikler
BackColor |
Çizilmekte olan öğenin arka plan rengini alır. |
Bounds |
Çizilmekte olan öğenin sınırlarını temsil eden dikdörtgeni alır. |
Font |
Çizilmekte olan öğeye atanan yazı tipini alır. |
ForeColor |
Çizilen öğenin ön plan rengini alır. |
Graphics |
Öğeyi çizmek için grafik yüzeyini alır. |
Index |
Çizilmekte olan öğenin dizin değerini alır. |
State |
Çizilen öğenin durumunu alır. |
Yöntemler
Dispose() |
Uygulama tarafından tanımlanan, yönetilmeyen kaynakları serbest bırakma, salma veya sıfırlama ile ilişkili görevleri gerçekleştirir. |
Dispose(Boolean) |
|
DrawBackground() |
Arka planı oluşturucuda DrawItemEventArgs belirtilen sınırlar içinde ve uygun renkle çizer. |
DrawFocusRectangle() |
Oluşturucuda belirtilen sınırlar içinde bir odak dikdörtgeni DrawItemEventArgs çizer. |
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) |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
Belirtik Arabirim Kullanımları
IDeviceContext.GetHdc() |
Tanıtıcıyı bir Windows cihaz bağlamı için döndürür. |
IDeviceContext.ReleaseHdc() |
Windows cihaz bağlamının tutamacını serbest bırakır. |