DrawItemEventArgs Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DrawItemEventArgs.cs

DrawItem olayı için veriler sağlar.

public ref class DrawItemEventArgs : EventArgs, IDisposable, System::Drawing::IDeviceContext

public class DrawItemEventArgs : EventArgs, IDisposable, System.Drawing.IDeviceContext

type DrawItemEventArgs = class
    inherit EventArgs
    interface IDisposable
    interface IDeviceContext

Public Class DrawItemEventArgs
Inherits EventArgs
Implements IDeviceContext, IDisposable

Devralma

Object

EventArgs

DrawItemEventArgs

Türetilmiş

System.Windows.Forms.StatusBarDrawItemEventArgs

Uygulamalar

IDeviceContext IDisposable

Ö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ştirmek için olayı 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 'a ListBox bu sırada "Apple", "Orange" ve "Plum" metinleriyle eklendiği 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 dizini, ve Graphics çizimin Rectangleüzerinde yapılması gerekenler de dahil olmak üzere tüm bilgileri içerir.

Oluşturucular

Name	Description
DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, Color, Color)	Belirtilen denetim için belirtilen yazı tipi, durum, ön plan rengi, arka plan rengi, çizecek yüzey ve içinde çizecek sınırlar ile sınıfın yeni bir örneğini DrawItemEventArgs başlatır.
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.

Özellikler

Name	Description
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	Çizilmekte olan öğ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	Çizilmekte olan öğenin durumunu alır.

Yöntemler

Name	Description
Dispose()	Yönetilmeyen kaynakları serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.
Dispose(Boolean)	DrawItem olayı için veriler sağlar.
DrawBackground()	Oluşturucuda DrawItemEventArgs belirtilen sınırların içinde ve uygun renkle arka planı çizer.
DrawFocusRectangle()	Oluşturucuda belirtilen sınırlar içinde bir odak dikdörtgeni DrawItemEventArgs çizer.

Belirtik Arabirim Kullanımları

Name	Description
IDeviceContext.GetHdc()	Tanıtıcıyı bir Windows cihaz bağlamı olarak döndürür.
IDeviceContext.ReleaseHdc()	Windows cihaz bağlamının tutamacını serbest bırakır.

Ayrıca bkz.

• DrawItemEventHandler
• ComboBox
• ListBox
• MenuItem
• TabControl