Aktualisiert: November 2007
Stellt Methoden bereit, mit denen Text bemessen und wiedergegeben wird. Die Klasse kann nicht geerbt werden.
Public NotInheritable Class TextRenderer
Dim instance As TextRenderer
public sealed class TextRenderer
public ref class TextRenderer sealed
public final class TextRenderer
Die TextRenderer-Klasse stellt einige static-Methoden bereit, die zum Bemessen und Zeichnen von Text in einem Windows Form-Steuerelement verwendet werden können.
Wie der Text gezeichnet wird, können Sie mithilfe einer der Überladungen von DrawText beeinflussen, die einen TextFormatFlags-Parameter akzeptiert. Standardmäßig fügt TextRenderer dem umgebenden Rechteck des gezeichneten Texts einen Abstand hinzu, damit überhängende Symbole aufgenommen werden können. Wenn Sie eine Textzeile ohne diesen zusätzlichen Leerraum zeichnen müssen, empfiehlt es sich, die Versionen von DrawText und MeasureText zu verwenden, die einen Size-Parameter und einen TextFormatFlags-Parameter akzeptieren. Ein Beispiel finden Sie unter MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).
Die DrawText-Methoden von TextRenderer werden beim Drucken nicht unterstützt. Verwenden Sie immer die DrawString-Methoden der Graphics-Klasse.
Im folgenden Codebeispiel wird die Verwendung der DrawText-Methode veranschaulicht. Fügen Sie zum Ausführen des Beispiels den Code in ein Windows Form ein, und rufen Sie RenderText1 im Paint-Ereignishandler des Formulars auf, wobei Sie e als PaintEventArgs übergeben.
Private Sub RenderText1(ByVal e As PaintEventArgs) TextRenderer.DrawText(e.Graphics, "Regular Text", _ Me.Font, New Point(10, 10), SystemColors.ControlText) End Sub
private void RenderText1(PaintEventArgs e) { TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font, new Point(10, 10), SystemColors.ControlText); }
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98