ListBox.OnDrawItem(DrawItemEventArgs) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Genera el evento DrawItem.

protected:
 virtual void OnDrawItem(System::Windows::Forms::DrawItemEventArgs ^ e);

protected virtual void OnDrawItem (System.Windows.Forms.DrawItemEventArgs e);

abstract member OnDrawItem : System.Windows.Forms.DrawItemEventArgs -> unit
override this.OnDrawItem : System.Windows.Forms.DrawItemEventArgs -> unit

Protected Overridable Sub OnDrawItem (e As DrawItemEventArgs)

Parámetros

e

DrawItemEventArgs

Objeto DrawItemEventArgs que contiene los datos del evento.

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. Este ejemplo 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 a 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

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado. Para obtener más información, consulte controlar y provocar eventos.

El OnDrawItem método también permite que las clases derivadas controle el evento sin adjuntar un delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.

Notas a los desarrolladores de herederos

Al reemplazar OnDrawItem(DrawItemEventArgs) en una clase derivada, asegúrese de llamar al método OnDrawItem(DrawItemEventArgs) de la clase base para que los delegados registrados reciban el evento.

Consulte también

• DrawItem