ListBox.DrawItem Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Se produce cuando cambia la apariencia de un control ListBox dibujado por el propietario.

public:
 event System::Windows::Forms::DrawItemEventHandler ^ DrawItem;

public event System.Windows.Forms.DrawItemEventHandler? DrawItem;

member this.DrawItem : System.Windows.Forms.DrawItemEventHandler 

Public Custom Event DrawItem As DrawItemEventHandler 

Tipo de evento

DrawItemEventHandler

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear elementos dibujados ListBox por el propietario. El código usa la DrawMode propiedad para especificar que los elementos dibujados tienen un tamaño fijo y el DrawItem evento para realizar el dibujo de cada elemento en .ListBox El código de ejemplo usa las propiedades y los métodos de la DrawItemEventArgs clase que se pasan como parámetro al controlador de eventos para dibujar los elementos. En este ejemplo se requiere que se haya agregado un ListBox control llamado listBox1 a un formulario y que el controlador de eventos definido en el código de ejemplo controle el DrawItem evento. El ejemplo también requiere que los elementos se hayan agregado al ListBox con el texto de "Apple", "Orange" y "Plum" en ese orden.

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

Comentarios

Este evento lo usa un propietario dibujado ListBox. El evento solo se genera cuando la DrawMode propiedad se establece DrawMode.OwnerDrawFixed en o DrawMode.OwnerDrawVariable. Puede usar este evento para realizar las tareas necesarias para dibujar elementos en .ListBox Si tiene un elemento de tamaño variable (cuando la DrawMode propiedad se establece DrawMode.OwnerDrawVariableen ), antes de dibujar un elemento, se genera el MeasureItem evento . Puede crear un controlador de eventos para el MeasureItem evento para especificar el tamaño del elemento que va a dibujar en el controlador de eventos para el DrawItem evento.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.

Consulte también

• OnDrawItem(DrawItemEventArgs)