ListView.DrawSubItem Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Se produce cuando se dibuja la vista de detalles de un control ListView y el valor de la propiedad OwnerDraw se ha establecido en true.

public:
 event System::Windows::Forms::DrawListViewSubItemEventHandler ^ DrawSubItem;

public event System.Windows.Forms.DrawListViewSubItemEventHandler? DrawSubItem;

member this.DrawSubItem : System.Windows.Forms.DrawListViewSubItemEventHandler 

Public Custom Event DrawSubItem As DrawListViewSubItemEventHandler 

Tipo de evento

DrawListViewSubItemEventHandler

Ejemplos

En el ejemplo de código siguiente se proporciona una implementación de un DrawSubItem controlador de eventos. Para obtener el ejemplo completo, consulte el tema de OwnerDraw referencia.

// Draws subitem text and applies content-based formatting.
private void listView1_DrawSubItem(object sender,
    DrawListViewSubItemEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Left;

    using (StringFormat sf = new StringFormat())
    {
        // Store the column text alignment, letting it default
        // to Left if it has not been set to Center or Right.
        switch (e.Header.TextAlign)
        {
            case HorizontalAlignment.Center:
                sf.Alignment = StringAlignment.Center;
                flags = TextFormatFlags.HorizontalCenter;
                break;
            case HorizontalAlignment.Right:
                sf.Alignment = StringAlignment.Far;
                flags = TextFormatFlags.Right;
                break;
        }

        // Draw the text and background for a subitem with a 
        // negative value. 
        double subItemValue;
        if (e.ColumnIndex > 0 && Double.TryParse(
            e.SubItem.Text, NumberStyles.Currency,
            NumberFormatInfo.CurrentInfo, out subItemValue) &&
            subItemValue < 0)
        {
            // Unless the item is selected, draw the standard 
            // background to make it stand out from the gradient.
            if ((e.ItemState & ListViewItemStates.Selected) == 0)
            {
                e.DrawBackground();
            }

            // Draw the subitem text in red to highlight it. 
            e.Graphics.DrawString(e.SubItem.Text,
                listView1.Font, Brushes.Red, e.Bounds, sf);

            return;
        }

        // Draw normal text for a subitem with a nonnegative 
        // or nonnumerical value.
        e.DrawText(flags);
    }
}

' Draws subitem text and applies content-based formatting.
Private Sub listView1_DrawSubItem(ByVal sender As Object, _
    ByVal e As DrawListViewSubItemEventArgs) _
    Handles listView1.DrawSubItem

    Dim flags As TextFormatFlags = TextFormatFlags.Left

    Dim sf As New StringFormat()
    Try

        ' Store the column text alignment, letting it default
        ' to Left if it has not been set to Center or Right.
        Select Case e.Header.TextAlign
            Case HorizontalAlignment.Center
                sf.Alignment = StringAlignment.Center
                flags = TextFormatFlags.HorizontalCenter
            Case HorizontalAlignment.Right
                sf.Alignment = StringAlignment.Far
                flags = TextFormatFlags.Right
        End Select

        ' Draw the text and background for a subitem with a 
        ' negative value. 
        Dim subItemValue As Double
        If e.ColumnIndex > 0 AndAlso _
            Double.TryParse(e.SubItem.Text, NumberStyles.Currency, _
            NumberFormatInfo.CurrentInfo, subItemValue) AndAlso _
            subItemValue < 0 Then

            ' Unless the item is selected, draw the standard 
            ' background to make it stand out from the gradient.
            If (e.ItemState And ListViewItemStates.Selected) = 0 Then
                e.DrawBackground()
            End If

            ' Draw the subitem text in red to highlight it. 
            e.Graphics.DrawString(e.SubItem.Text, _
                Me.listView1.Font, Brushes.Red, e.Bounds, sf)

            Return

        End If

        ' Draw normal text for a subitem with a nonnegative 
        ' or nonnumerical value.
        e.DrawText(flags)

    Finally
        sf.Dispose()
    End Try

End Sub

Comentarios

Este evento le permite personalizar la apariencia de un ListView control mediante el dibujo del propietario. Se genera solo cuando la OwnerDraw propiedad se establece true en y la View propiedad se establece en View.Details. Para obtener más información sobre el dibujo del propietario, consulte el OwnerDraw tema de referencia de propiedades.

Nota

La información del subelemento suele aparecer en la vista de mosaico, así como en la vista de detalles, pero en la vista de mosaico, debe dibujarse en un controlador para el DrawItem evento.

El DrawSubItem evento puede producirse para cada ListView subelemento. Puede controlar el DrawItem evento para dibujar elementos comunes a todos los subelementos, como el fondo, y controlar el DrawSubItem evento para dibujar elementos para subelementos individuales, como valores de texto. También puede dibujar todos los elementos del ListView control utilizando solo uno de los dos eventos, aunque esto puede ser menos conveniente. Para dibujar encabezados de columna en la vista de detalles, debe controlar el DrawColumnHeader evento.

Nota

El DrawSubItem evento no se produce para ningún subelemento para el que no se haya agregado ningún ColumnHeader objeto a la Columns colección. Tenga en cuenta también que el primer subelemento de cada ListViewItem objeto representa el propio elemento primario y se muestra en la primera columna.

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

Consulte también

• ColumnHeader
• DrawListViewSubItemEventArgs
• DrawItem
• DrawColumnHeader
• ListViewItem.ListViewSubItem
• OwnerDraw
• View
• View