Comment : écrire du texte avec GDI

  • Article

Avec la méthode de la TextRenderer classe, vous pouvez accéder aux fonctionnalités GDI pour dessiner du DrawText 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 DrawText méthodes de la TextRenderer classe ne sont pas prises en charge pour l’impression. Lors de l’impression, utilisez toujours les DrawString méthodes de la Graphics classe.

Exemple

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

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);
}

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

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

Pour plus d’informations sur l’obtention d’un Graphicsobjet graphique, consultez Guide pratique pour créer des objets graphiques pour le dessin. Pour plus d’informations sur la construction d’une Fontpolice, consultez Comment : construire des familles de polices et des polices.

Compilation du code

L’exemple de code précédent est conçu pour une utilisation avec Windows Forms, et nécessite le PaintEventArgseparamètre , qui est un paramètre de PaintEventHandler.

Voir aussi