DrawListViewItemEventArgs.DrawText Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Dessine le texte de l’utilisation ListViewItem de sa couleur de premier plan actuelle et de la mise en forme par défaut.

Surcharges

Nom	Description
DrawText()	Dessine le texte de l’utilisation ListViewItem de sa couleur de premier plan actuelle.
DrawText(TextFormatFlags)	Dessine le texte de l’utilisation ListViewItem de sa couleur de premier plan actuelle et la mise en forme avec les valeurs spécifiées TextFormatFlags .

DrawText()

Source:

DrawListViewItemEventArgs.cs

Dessine le texte de l’utilisation ListViewItem de sa couleur de premier plan actuelle.

public:
 void DrawText();

public void DrawText();

member this.DrawText : unit -> unit

Public Sub DrawText ()

Exemples

L’exemple de code suivant montre comment utiliser la DrawText méthode dans une application qui fournit un dessin personnalisé pour un ListView contrôle. Dans l’exemple, un gestionnaire pour l’événement ListView.DrawItem dessine l’arrière-plan pour les éléments entiers. Dans toutes les vues, à l’exception de la vue détails, ce gestionnaire dessine également le texte de premier plan. Dans la vue détails, le texte de premier plan est dessiné dans l’événement ListView.DrawSubItem .

Pour obtenir l’exemple complet, consultez la rubrique de référence de vue d’ensemble DrawListViewItemEventArgs .

// Draws the backgrounds for entire ListView items.
private void listView1_DrawItem(object sender,
    DrawListViewItemEventArgs e)
{
    if ((e.State & ListViewItemStates.Selected) != 0)
    {
        // Draw the background and focus rectangle for a selected item.
        e.Graphics.FillRectangle(Brushes.Maroon, e.Bounds);
        e.DrawFocusRectangle();
    }
    else
    {
        // Draw the background for an unselected item.
        using (LinearGradientBrush brush =
            new LinearGradientBrush(e.Bounds, Color.Orange,
            Color.Maroon, LinearGradientMode.Horizontal))
        {
            e.Graphics.FillRectangle(brush, e.Bounds);
        }
    }

    // Draw the item text for views other than the Details view.
    if (listView1.View != View.Details)
    {
        e.DrawText();
    }
}

' Draws the backgrounds for entire ListView items.
Private Sub listView1_DrawItem(ByVal sender As Object, _
    ByVal e As DrawListViewItemEventArgs) _
    Handles listView1.DrawItem

    If Not (e.State And ListViewItemStates.Selected) = 0 Then

        ' Draw the background for a selected item.
        e.Graphics.FillRectangle(Brushes.Maroon, e.Bounds)
        e.DrawFocusRectangle()

    Else

        ' Draw the background for an unselected item.
        Dim brush As New LinearGradientBrush(e.Bounds, Color.Orange, _
            Color.Maroon, LinearGradientMode.Horizontal)
        Try
            e.Graphics.FillRectangle(brush, e.Bounds)
        Finally
            brush.Dispose()
        End Try

    End If

    ' Draw the item text for views other than the Details view.
    If Not Me.listView1.View = View.Details Then
        e.DrawText()
    End If

End Sub

Remarques

Utilisez cette méthode pour dessiner le texte de l’élément à l’aide des valeurs actuelles des propriétés et ListViewItem.Font des ListViewItem.ForeColor propriétés. Le texte est dessiné dans la zone spécifiée par la Bounds propriété. Vous pouvez également dessiner le texte manuellement à l’aide de la GraphicsGraphics propriété récupérée.

La DrawText méthode est la plus utile lorsque la ListView.View propriété est définie sur une valeur autre que View.Details. Dans la vue détails, cette méthode dessine le texte du ListViewItemtexte, mais ne dessine pas le texte pour les sous-éléments. Par conséquent, dans l’affichage des détails, il est généralement plus pratique de dessiner tout le ListView texte dans un gestionnaire pour l’événement ListView.DrawSubItem .

Voir aussi

• Bounds
• Graphics
• ListView
• DrawItem
• DrawSubItem
• View
• ListViewItem
• Font
• ForeColor

DrawText(TextFormatFlags)

Source:

DrawListViewItemEventArgs.cs

Dessine le texte de l’utilisation ListViewItem de sa couleur de premier plan actuelle et la mise en forme avec les valeurs spécifiées TextFormatFlags .

public:
 void DrawText(System::Windows::Forms::TextFormatFlags flags);

public void DrawText(System.Windows.Forms.TextFormatFlags flags);

member this.DrawText : System.Windows.Forms.TextFormatFlags -> unit

Public Sub DrawText (flags As TextFormatFlags)

Paramètres

flags

TextFormatFlags

Combinaison de valeurs au niveau du TextFormatFlags bit.

Remarques

Utilisez cette méthode pour dessiner le texte de l’élément à l’aide des valeurs actuelles des propriétés et ListViewItem.Font des ListViewItem.ForeColor propriétés. Les TextFormatFlags valeurs spécifiées dans le flags paramètre vous permettent de fournir des propriétés de mise en forme pour l’étiquette de nœud, telles que l’alignement du texte. Le texte est dessiné dans la zone spécifiée par la Bounds propriété. Vous pouvez également dessiner le texte manuellement à l’aide de la GraphicsGraphics propriété récupérée.

La DrawText méthode est la plus utile lorsque la ListView.View propriété est définie sur une valeur autre que View.Details. Dans la vue détails, cette méthode dessine le texte du ListViewItemtexte, mais ne dessine pas le texte pour les sous-éléments. Par conséquent, dans l’affichage des détails, il est généralement plus pratique de dessiner tout le ListView texte dans un gestionnaire pour l’événement ListView.DrawSubItem .

Voir aussi

• Bounds
• Graphics
• ListView
• DrawItem
• DrawSubItem
• View
• ListViewItem
• Font
• ForeColor
• TextFormatFlags