Comment : écrire du texte avec GDI
Avec la méthode DrawText de la classe TextRenderer, vous pouvez accéder aux fonctionnalités GDI de dessin de texte sur un formulaire ou un contrôle. Le rendu de texte GDI offre en général de meilleures performances et une mesure de texte plus exacte que GDI+.
Notes
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.
Compilation du code
L'exemple de code précédent est destiné à une utilisation avec Windows Forms et nécessite PaintEventArgs e, qui est un paramètre de PaintEventHandler.