TextRenderer Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Methoden bereit, mit denen Text bemessen und gerendert wird. Diese Klasse kann nicht vererbt werden.

public ref class TextRenderer sealed

public ref class TextRenderer abstract sealed

public sealed class TextRenderer

public static class TextRenderer

type TextRenderer = class

Public NotInheritable Class TextRenderer

Public Class TextRenderer

Vererbung: Object
TextRenderer

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die DrawText-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den Code in eine Windows Form ein, und rufen Sie RenderText1 aus dem Ereignishandler des Formulars Paint auf, indem Sie als PaintEventArgsübergebene.

private void RenderText1(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font, 
        new Point(10, 10), SystemColors.ControlText);
}

Private Sub RenderText1(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", _
        Me.Font, New Point(10, 10), SystemColors.ControlText)

End Sub

Hinweise

Die TextRenderer -Klasse stellt eine Reihe von Methoden bereit, die zum Messen und Zeichnen von static 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).

Hinweis

Die DrawTextt-Methoden von TextRenderer werden zum Drucken nicht unterstützt. Sie sollten immer die DrawString Methoden der Graphics -Klasse verwenden.

Methoden

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Zeichnet den angegebenen Text an der angegebenen Position und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart und Farbe.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Zeichnet den angegebenen Text an der angegebenen Position und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und Hintergrundfarbe.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Zeichnet den angegebenen Text an der angegebenen Position und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe, Hintergrundfarbe und die angegebenen Formatierungsanweisungen.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Zeichnet den angegebenen Text an der angegebenen Position und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und die angegebenen Formatierungsanweisungen.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet den angegebenen Gerätekontext sowie die angegebene Schriftart und Farbe.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und Hintergrundfarbe.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe, Hintergrundfarbe und die angegebenen Formatierungsanweisungen.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und die angegebenen Formatierungsanweisungen.
DrawText(IDeviceContext, String, Font, Point, Color)	Zeichnet den angegebenen Text an der angegebenen Position und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart und Farbe.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Zeichnet den angegebenen Text an der angegebenen Position und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und Hintergrundfarbe.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Zeichnet den angegebenen Text an der angegebenen Position und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe, Hintergrundfarbe und die angegebenen Formatierungsanweisungen.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Zeichnet den angegebenen Text an der angegebenen Position und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und die angegebenen Formatierungsanweisungen.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet den angegebenen Gerätekontext sowie die angegebene Schriftart und Farbe.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und Hintergrundfarbe.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe, Hintergrundfarbe und die angegebenen Formatierungsanweisungen.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und die angegebenen Formatierungsanweisungen.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser in der angegebenen Schriftart im angegebenen Gerätekontext gezeichnet wird.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser mit der angegebenen Schriftart im angegebenen Gerätekontext gezeichnet wird und dabei mithilfe der angegebenen Größe ein anfängliches umgebendes Rechteck für den Text erstellt wird.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser mit dem angegebenen Gerätekontext, mit der angegebenen Schriftart und entsprechend den angegebenen Formatierungsanweisungen gezeichnet wird und dabei mithilfe der angegebenen Größe das anfängliche umgebende Rechteck für den Text erstellt wird.
MeasureText(IDeviceContext, String, Font)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser in der angegebenen Schriftart im angegebenen Gerätekontext gezeichnet wird.
MeasureText(IDeviceContext, String, Font, Size)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser mit der angegebenen Schriftart im angegebenen Gerätekontext gezeichnet wird und dabei mithilfe der angegebenen Größe ein anfängliches umgebendes Rechteck für den Text erstellt wird.
MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser mit dem angegebenen Gerätekontext, mit der angegebenen Schriftart und entsprechend den angegebenen Formatierungsanweisungen gezeichnet wird und dabei mithilfe der angegebenen Größe das anfängliche umgebende Rechteck für den Text erstellt wird.
MeasureText(ReadOnlySpan<Char>, Font)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser in der angegebenen Schriftart gezeichnet wird.
MeasureText(ReadOnlySpan<Char>, Font, Size)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser mit der angegebenen Schriftart gezeichnet wird und dabei mithilfe der angegebenen Größe ein anfängliches umgebendes Rechteck erstellt wird.
MeasureText(ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser mit der angegebenen Schriftart und entsprechend den angegebenen Formatierungsanweisungen gezeichnet wird und dabei mithilfe der angegebenen Größe das anfängliche umgebende Rechteck für den Text erstellt wird.
MeasureText(String, Font)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser in der angegebenen Schriftart gezeichnet wird.
MeasureText(String, Font, Size)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser mit der angegebenen Schriftart gezeichnet wird und dabei mithilfe der angegebenen Größe ein anfängliches umgebendes Rechteck erstellt wird.
MeasureText(String, Font, Size, TextFormatFlags)	Gibt die Größe des angegebenen Texts in Pixel an, wenn dieser mit der angegebenen Schriftart und entsprechend den angegebenen Formatierungsanweisungen gezeichnet wird und dabei mithilfe der angegebenen Größe das anfängliche umgebende Rechteck für den Text erstellt wird.

Gilt für: