TextRenderer Klasse

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

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 zum Messen und Rendern von Text bereit. 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

Im folgenden Codebeispiel wird die Verwendung der DrawText Methode veranschaulicht. Um dieses Beispiel auszuführen, fügen Sie den Code in ein Windows Formular ein, und rufen Sie RenderText1 aus dem ereignishandler Paint des Formulars auf, und übergeben Sie e als PaintEventArgs.

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 klasse TextRenderer stellt eine Reihe von static Methoden bereit, die zum Messen und Zeichnen von Text in einem Windows Formularsteuerelement verwendet werden können.

Sie können ändern, wie der Text gezeichnet wird, indem Sie eine der DrawText Überladungen verwenden, die einen TextFormatFlags Parameter verwenden. Das Standardverhalten des TextRenderer Beispiels besteht darin, dem umgebenden Rechteck des gezeichneten Texts Abstand hinzuzufügen, um überhangende Glyphen aufzunehmen. Wenn Sie eine Textzeile ohne diese zusätzlichen Leerzeichen zeichnen müssen, sollten Sie die Versionen DrawText MeasureText und parameter Size TextFormatFlags verwenden. Ein Beispiel finden Sie unter MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Note

Die DrawText Methoden des Druckens TextRenderer werden nicht unterstützt. Sie sollten immer die DrawString Methoden der Graphics Klasse verwenden.

Methoden

Name	Beschreibung
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe, der Hintergrundfarbe und der Formatierungsanweisungen.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Zeichnet den angegebenen Text an der angegebenen Position unter Verwendung des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Hintergrundfarbe.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Formatierungsanweisungen.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart und der Farbe.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe, der Hintergrundfarbe und der Formatierungsanweisungen.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Hintergrundfarbe.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Formatierungsanweisungen.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen unter Verwendung des angegebenen Gerätekontexts, der Schriftart und der Farbe.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe, der Hintergrundfarbe und der Formatierungsanweisungen.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Zeichnet den angegebenen Text an der angegebenen Position unter Verwendung des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Hintergrundfarbe.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Formatierungsanweisungen.
DrawText(IDeviceContext, String, Font, Point, Color)	Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart und der Farbe.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe, der Hintergrundfarbe und der Formatierungsanweisungen.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Hintergrundfarbe.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Formatierungsanweisungen.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen unter Verwendung des angegebenen Gerätekontexts, der Schriftart und der Farbe.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit dem angegebenen Gerätekontext, der Schriftart und den Formatierungsanweisungen gezeichnet wird, wobei die angegebene Größe verwendet wird, um das anfängliche Begrenzungsrechteck für den Text zu erstellen.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit der angegebenen Schriftart im angegebenen Gerätekontext gezeichnet wird, wobei die angegebene Größe verwendet wird, um ein anfängliches Begrenzungsrechteck für den Text zu erstellen.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font)	Stellt die Größe des angegebenen Texts in Pixeln bereit, der mit der angegebenen Schriftart im angegebenen Gerätekontext gezeichnet wird.
MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit dem angegebenen Gerätekontext, der Schriftart und den Formatierungsanweisungen gezeichnet wird, wobei die angegebene Größe verwendet wird, um das anfängliche Begrenzungsrechteck für den Text zu erstellen.
MeasureText(IDeviceContext, String, Font, Size)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit der angegebenen Schriftart im angegebenen Gerätekontext gezeichnet wird, wobei die angegebene Größe verwendet wird, um ein anfängliches Begrenzungsrechteck für den Text zu erstellen.
MeasureText(IDeviceContext, String, Font)	Stellt die Größe des angegebenen Texts in Pixeln bereit, der mit der angegebenen Schriftart im angegebenen Gerätekontext gezeichnet wird.
MeasureText(ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit den angegebenen Schriftart- und Formatierungsanweisungen gezeichnet wird, wobei die angegebene Größe verwendet wird, um das anfängliche Begrenzungsrechteck für den Text zu erstellen.
MeasureText(ReadOnlySpan<Char>, Font, Size)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit der angegebenen Schriftart gezeichnet wird, wobei die angegebene Größe verwendet wird, um ein anfängliches umgebendes Rechteck zu erstellen.
MeasureText(ReadOnlySpan<Char>, Font)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit der angegebenen Schriftart gezeichnet wird.
MeasureText(String, Font, Size, TextFormatFlags)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit den angegebenen Schriftart- und Formatierungsanweisungen gezeichnet wird, wobei die angegebene Größe verwendet wird, um das anfängliche Begrenzungsrechteck für den Text zu erstellen.
MeasureText(String, Font, Size)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit der angegebenen Schriftart gezeichnet wird, wobei die angegebene Größe verwendet wird, um ein anfängliches umgebendes Rechteck zu erstellen.
MeasureText(String, Font)	Stellt die Größe des angegebenen Texts in Pixeln bereit, wenn er mit der angegebenen Schriftart gezeichnet wird.

Gilt für:

Feedback

War diese Seite hilfreich?