ListView.DrawSubItem Événement

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Se produit lorsque le mode Détails de ListView est dessiné et que la propriété OwnerDraw a la valeur 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 

Type d'événement

DrawListViewSubItemEventHandler

Exemples

L’exemple de code suivant fournit une implémentation d’un gestionnaire d’événements DrawSubItem . Pour obtenir l’exemple complet, consultez la rubrique de OwnerDraw référence.

// 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

Remarques

Cet événement vous permet de personnaliser l’apparence d’un ListView contrôle à l’aide du dessin du propriétaire. Elle est levée uniquement lorsque la OwnerDraw propriété a la true valeur et que la propriété a la View.DetailsView valeur . Pour plus d’informations sur le dessin propriétaire, consultez la rubrique de référence sur les OwnerDraw propriétés.

Notes

Les informations de sous-élément apparaissent généralement dans la vue vignette ainsi que dans la vue détails, mais dans la vue vignette, elles doivent être dessinées dans un gestionnaire pour l’événement DrawItem .

L’événement DrawSubItem peut se produire pour chaque ListView sous-élément. Vous pouvez gérer l’événement DrawItem pour dessiner des éléments communs à tous les sous-éléments, tels que l’arrière-plan, et gérer l’événement DrawSubItem pour dessiner des éléments pour des sous-éléments individuels, tels que des valeurs de texte. Vous pouvez également dessiner tous les éléments du contrôle à l’aide ListView d’un seul des deux événements, bien que cela puisse être moins pratique. Pour dessiner des en-têtes de colonne dans l’affichage détails, vous devez gérer l’événement DrawColumnHeader .

Notes

L’événement DrawSubItem ne se produit pas pour les sous-éléments pour lesquels aucun objet n’a ColumnHeader été ajouté à la Columns collection. Notez également que le premier sous-élément de chaque ListViewItem objet représente l’élément parent lui-même et s’affiche dans la première colonne.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

Voir aussi

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