DrawItemEventArgs Класс

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет данные о событии DrawItem.

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

Наследование: Object

EventArgs
DrawItemEventArgs

Производный: System.Windows.Forms.StatusBarDrawItemEventArgs

Реализации: IDeviceContext IDisposable

Примеры

В следующем примере показано, как создавать элементы, нарисованные владельцем ListBox . Код использует DrawMode свойство , чтобы указать, что нарисованные элементы имеют фиксированный размер и DrawItem событие для рисования каждого элемента в .ListBox В примере кода для рисования DrawItemEventArgs элементов используются свойства и методы класса , переданного в качестве параметра обработчику событий. В этом примере предполагается, что ListBox элемент управления с именем listBox1 был добавлен в форму и что DrawItem событие обрабатывается обработчиком событий, определенным в примере кода. В примере также предполагается, что элементы были добавлены ListBox в с текстом "Apple", "Orange" и "Plum" в указанном порядке.

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

Событие DrawItem вызывается элементами управления рисования владельца, такими как ListBox элементы управления и ComboBox . Он содержит все сведения, необходимые пользователю для рисования указанного элемента, включая индекс элемента, Rectangleи Graphics объект , для которого необходимо выполнить рисование.

Конструкторы

DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState)	Инициализирует новый экземпляр класса DrawItemEventArgs для заданного элемента управления с заданным шрифтом, состоянием, поверхностью для рисования и границами рисунка.
DrawItemEventArgs(Graphics, Font, Rectangle, Int32, DrawItemState, Color, Color)	Инициализирует новый экземпляр класса DrawItemEventArgs для заданного элемента управления с заданным шрифтом, состоянием, основным цветом, цветом фона, поверхностью для рисования и границами рисунка.

Свойства

BackColor	Получает цвет фона для изображаемого элемента.
Bounds	Получает прямоугольник, представляющий собой границы изображаемого элемента.
Font	Получает шрифт, назначенный изображаемому элементу.
ForeColor	Получает основной цвет изображаемого элемента.
Graphics	Получает графическую поверхность, используемую для рисования элемента.
Index	Получает значение индекса для изображаемого элемента.
State	Получает состояние изображаемого элемента.

Методы

Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.
Dispose(Boolean)	Предоставляет данные о событии `DrawItem`.
DrawBackground()	Рисует фон в пределах границ, заданных в конструкторе DrawItemEventArgs, используя указанный цвет.
DrawFocusRectangle()	Рисует прямоугольник фокуса в пределах границ, заданных в конструкторе DrawItemEventArgs.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

IDeviceContext.GetHdc()	Возвращает дескриптор контекста устройства Windows.
IDeviceContext.ReleaseHdc()	Освобождает дескриптор контекста устройства Windows.

Применяется к

Поделиться через