Comment : écrire du texte avec GDI

Article
08/21/2008

Mise à jour : novembre 2007

Avec la méthode DrawText dans la classe TextRenderer, vous pouvez accéder aux fonctionnalités GDI pour dessiner du texte sur un formulaire ou un contrôle. Le rendu de texte GDI offre généralement de meilleures performances et une mesure de texte plus précise que GDI+.

Remarque :
Les méthodes DrawText de la classe TextRenderer ne sont pas prises en charge pour l'impression. Lorsque vous imprimez, utilisez toujours les méthodes DrawString de la classe Graphics.

Exemple

L'exemple de code suivant montre comment dessiner du texte sur plusieurs lignes dans un rectangle à l'aide de la méthode DrawText.

Private Sub RenderText6(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
        TextFormatFlags.EndEllipsis
    TextRenderer.DrawText(e.Graphics, _
    "This is some text that will be clipped at the end.", _
    Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)

End Sub

private void RenderText6(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
    TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}

Pour restituer le texte avec la classe TextRenderer, vous avez besoin d'un IDeviceContext, tel qu'un Graphics et une Font, un emplacement pour dessiner le texte, et la couleur dans laquelle il doit être dessiné. Vous pouvez également spécifier la mise en forme du texte à l'aide de l'énumération TextFormatFlags.

Pour plus d'informations sur l'obtention d'un Graphics, consultez Comment : créer des objets graphiques pour le dessin. Pour plus d'informations sur la construction d'un Font, consultez Comment : construire des familles de polices et des polices.