Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

TextRenderer-Klasse

Aktualisiert: November 2007

Stellt Methoden bereit, mit denen Text bemessen und wiedergegeben wird. Die Klasse kann nicht geerbt werden.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
public sealed class TextRenderer
public final class TextRenderer
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).

exkzzayx.alert_note(de-de,VS.90).gif Hinweis:

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 void RenderText1(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font, 
        new Point(10, 10), SystemColors.ControlText);

}


System.Object
  System.Windows.Forms.TextRenderer
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ