Comment : dessiner du texte sur l'arrière-plan d'un contrôle

Mise à jour : novembre 2007

Vous pouvez attirer directement le texte à l'arrière-plan d'un contrôle en convertissant une chaîne de texte en objet FormattedText, et attirer ensuite l'objet au DrawingContext du contrôle. Vous pouvez également utiliser cette technique pour attirer à l'arrière-plan d'objets dérivés de Panel, tels que Canvas et StackPanel.

Exemple de contrôles avec les arrière-plan de texte personnalisés

Exemple

Pour attirer à l'arrière-plan d'un contrôle, créez un objet DrawingBrush et attirez le texte converti sur le DrawingContextde l'objet. Puis, assignez le nouveau DrawingBrush à la propriété d'arrière-plan du contrôle.

L'exemple de code suivant montre comment créer un objet FormattedText et attirer à l'arrière-plan d'un objet Label et Button.

// Handle the WindowLoaded event for the window.
private void WindowLoaded(object sender, EventArgs e) 
{
    // Update the background property of the label and button.
    myLabel.Background = new DrawingBrush(DrawMyText("My Custom Label"));
    myButton.Background = new DrawingBrush(DrawMyText("Display Text"));
}

// Convert the text string to a geometry and draw it to the control's DrawingContext.
private Drawing DrawMyText(string textString)
{
    // Create a new DrawingGroup of the control.
    DrawingGroup drawingGroup = new DrawingGroup();

    // Open the DrawingGroup in order to access the DrawingContext.
    using (DrawingContext drawingContext = drawingGroup.Open())
    {
        // Create the formatted text based on the properties set.
        FormattedText formattedText = new FormattedText(
            textString,
            CultureInfo.GetCultureInfo("en-us"),
            FlowDirection.LeftToRight,
            new Typeface("Comic Sans MS Bold"),
            48,
            System.Windows.Media.Brushes.Black // This brush does not matter since we use the geometry of the text. 
            );

        // Build the geometry object that represents the text.
        Geometry textGeometry = formattedText.BuildGeometry(new System.Windows.Point(20, 0));

        // Draw a rounded rectangle under the text that is slightly larger than the text.
        drawingContext.DrawRoundedRectangle(System.Windows.Media.Brushes.PapayaWhip, null, new Rect(new System.Windows.Size(formattedText.Width + 50, formattedText.Height + 5)), 5.0, 5.0);

        // Draw the outline based on the properties that are set.
        drawingContext.DrawGeometry(System.Windows.Media.Brushes.Gold, new System.Windows.Media.Pen(System.Windows.Media.Brushes.Maroon, 1.5), textGeometry);

        // Return the updated DrawingGroup content to be used by the control.
        return drawingGroup;
    }
}

Remarque :
Pour obtenir l'exemple de code complet dont a été extrait l'exemple de code suivant, consultez Dessiner du texte sur l'arrière-plan d'un contrôle, exemple.

Voir aussi

Concepts

Dessin du texte mis en forme

Référence

FormattedText