DrawItemEventArgs Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menyediakan data untuk peristiwa tersebut DrawItem .

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

Warisan

Object

EventArgs

DrawItemEventArgs

Turunan

System.Windows.Forms.StatusBarDrawItemEventArgs

Penerapan

IDeviceContext IDisposable

Contoh

Contoh berikut menunjukkan cara membuat item yang digambar ListBox pemilik. Kode menggunakan DrawMode properti untuk menentukan bahwa item yang digambar berukuran tetap dan DrawItem peristiwa untuk melakukan gambar setiap item ke dalam ListBox. Contoh kode menggunakan properti dan metode kelas yang DrawItemEventArgs diteruskan sebagai parameter ke penanganan aktivitas untuk menggambar item. Contoh ini mengasumsikan bahwa ListBox kontrol yang diberi nama listBox1 telah ditambahkan ke formulir dan bahwa peristiwa ditangani DrawItem oleh penanganan aktivitas yang ditentukan dalam kode contoh. Contohnya juga mengasumsikan bahwa item telah ditambahkan ke ListBox dengan teks "Apple", "Oranye", dan "Plum" dalam urutan tersebut.

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

Keterangan

Peristiwa DrawItem ini dimunculkan oleh kontrol gambar pemilik, seperti ListBox kontrol dan ComboBox . Ini berisi semua informasi yang diperlukan pengguna untuk melukis item yang ditentukan, termasuk indeks item, Rectangle, dan Graphics tempat gambar harus dilakukan.

Konstruktor

DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState)	Menginisialisasi instans DrawItemEventArgs baru kelas untuk kontrol yang ditentukan dengan font, status, permukaan yang ditentukan untuk digambar, dan batas untuk menggambar di dalamnya.
DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, Color, Color)	Menginisialisasi instans DrawItemEventArgs baru kelas untuk kontrol yang ditentukan dengan font, status, warna latar depan, warna latar belakang, permukaan untuk menggambar, dan batas untuk menggambar di dalamnya.

Properti

BackColor	Mendapatkan warna latar belakang item yang sedang digambar.
Bounds	Mendapatkan persegi panjang yang mewakili batas item yang sedang digambar.
Font	Mendapatkan font yang ditetapkan ke item yang sedang digambar.
ForeColor	Mendapatkan warna latar depan item yang sedang digambar.
Graphics	Mendapatkan permukaan grafis untuk menggambar item.
Index	Mendapatkan nilai indeks item yang sedang digambar.
State	Mendapatkan status item yang sedang digambar.

Metode

Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
Dispose(Boolean)	Menyediakan data untuk peristiwa tersebut DrawItem .
DrawBackground()	Menggambar latar belakang dalam batas yang ditentukan dalam DrawItemEventArgs konstruktor dan dengan warna yang sesuai.
DrawFocusRectangle()	Menggambar persegi panjang fokus di dalam batas yang ditentukan dalam DrawItemEventArgs konstruktor.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

IDeviceContext.GetHdc()	Mengembalikan handel ke konteks perangkat Windows.
IDeviceContext.ReleaseHdc()	Merilis handel konteks perangkat Windows.

Lihat juga

• DrawItemEventHandler
• ComboBox
• ListBox
• MenuItem
• TabControl