TextRenderer.DrawText Methode

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.

Zeichnet den angegebenen Text an der angegebenen Position unter Verwendung des angegebenen Gerätekontexts, der Farbe und der Schriftart.

Überlädt

Name	Beschreibung
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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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)	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)	Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen unter Verwendung des angegebenen Gerätekontexts, der Schriftart und der Farbe.
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.

Hinweise

Das von der TextRenderer-Klasse angebotene Textrendering basiert auf dem GDI-Textrendering und wird für das Drucken von Windows Forms nicht unterstützt. Verwenden Sie stattdessen die DrawString Methoden der Graphics Klasse.

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart und der Farbe.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor);

public static void DrawText(System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: ReadOnlySpan<Char>

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

pt: Point

Dies Point stellt die obere linke Ecke des gezeichneten Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

Ausnahmen

ArgumentNullException

dc ist null.

Gilt für:

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe, der Hintergrundfarbe und der Formatierungsanweisungen.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: String

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

bounds: Rectangle

Dies Rectangle stellt die Grenzen des Texts dar.

foreColor: Color

Der Color auf den Text angewendet werden soll.

backColor: Color

Die Color anwendung auf den bereich dargestellt durch bounds.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags Werte.

Ausnahmen

ArgumentNullException

dc ist null.

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 RenderText8 aus dem ereignishandler Paint des Formulars auf, und übergeben Sie e als PaintEventArgs.

private void RenderText8(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.WordBreak;
    TextRenderer.DrawText(e.Graphics, "This is some text that will display on multiple lines.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, SystemColors.ControlDark, flags);
}

Private Sub RenderText8(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = _
        TextFormatFlags.Bottom Or TextFormatFlags.WordBreak
    TextRenderer.DrawText(e.Graphics, _
        "This is some text that will display on multiple lines.", _
        Me.Font, New Rectangle(10, 10, 100, 50), _
        SystemColors.ControlText, SystemColors.ControlDark, flags)

End Sub

Hinweise

Der backcolor Parameter wird auf den Bereich innerhalb des bounds Parameters. If fontforecolor oder ist backcolor oder nullEmpty, bzw. , bzw. , angewendet. Die DrawText Methode zeichnet den Text in der Schriftart oder Farbe, die aktuell im durch den gerätekontext angegebenen .dc Wenn forecolor dies der Wert ist Transparent, wird der Text nicht gezeichnet.

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).

Das TextRenderer Hinzufügen von Tabstopps zum gezeichneten Text wird nicht unterstützt, sie können jedoch vorhandene Tabstopps mithilfe der ExpandTabs Kennzeichnung erweitern.

Gilt für:

DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe, der Hintergrundfarbe und der Formatierungsanweisungen.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: String

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

pt: Point

Dies Point stellt die obere linke Ecke des gezeichneten Texts dar.

foreColor: Color

Der Color auf den Text angewendet werden soll.

backColor: Color

Der Color auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags Werte.

Ausnahmen

ArgumentNullException

dc ist null.

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 RenderText7 aus dem ereignishandler Paint des Formulars auf, und übergeben Sie e als PaintEventArgs.

private void RenderText7(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "This is some text.", this.Font,
        new Point(10, 10), Color.White, Color.SteelBlue, TextFormatFlags.Default);
}

Private Sub RenderText7(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "This is some text.", _
        Me.Font, New Point(10, 10), Color.White, Color.SteelBlue, _
        TextFormatFlags.Default)

End Sub

Hinweise

Der backcolor Parameter wird auf den rechteckigen Bereich angewendet, der den gezeichneten Text enthält. Ist font oder ist forecolor oder nullEmpty , bzw. ist die Methode; die DrawText Methode zeichnet den Text in der Schriftart oder Farbe, die aktuell im durch den angegebenen Gerätekontext ausgewählt istdc. Wenn forecolor dies der Wert ist Transparent, wird der Text nicht gezeichnet.

Das TextRenderer Hinzufügen von Tabstopps zum gezeichneten Text wird nicht unterstützt, sie können jedoch vorhandene Tabstopps mithilfe der ExpandTabs Kennzeichnung erweitern.

Note

Die methoden DrawText, die eine Point angeben, da die obere linke Ecke des gezeichneten Texts in Windows 2000 nicht ordnungsgemäß gerendert wird. Wenn Ihre Anwendung für Computer vorgesehen ist, die Windows 2000 ausgeführt werden, sollten Sie eine der DrawText Methoden verwenden, die eine Rectangle für die Grenzen des gezeichneten Texts angeben.

Gilt für:

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe, der Hintergrundfarbe und der Formatierungsanweisungen.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: ReadOnlySpan<Char>

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

pt: Point

Dies Point stellt die obere linke Ecke des gezeichneten Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

backColor: Color

Der Color auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags Werte.

Ausnahmen

ArgumentNullException

dc ist null.

ArgumentOutOfRangeException

ModifyString ist festgelegt.

Gilt für:

DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Formatierungsanweisungen.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, flags As TextFormatFlags)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: String

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

bounds: Rectangle

Dies Rectangle stellt die Grenzen des Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags Werte.

Ausnahmen

ArgumentNullException

dc ist null.

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 RenderText6 aus dem ereignishandler Paint des Formulars auf, und übergeben Sie e als PaintEventArgs.

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);
}

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

Hinweise

Ist font oder ist color oder nullEmpty , bzw. ist die Methode; die DrawText Methode zeichnet den Text in der Schriftart oder Farbe, die aktuell im durch den angegebenen Gerätekontext ausgewählt istdc. Wenn forecolor dies der Wert ist Transparent, wird der Text nicht gezeichnet.

Das TextRenderer Hinzufügen von Tabstopps zum gezeichneten Text wird nicht unterstützt, sie können jedoch vorhandene Tabstopps mithilfe der ExpandTabs Kennzeichnung erweitern.

Gilt für:

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Hintergrundfarbe.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText(System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

public static void DrawText(System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, backColor As Color)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: String

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

bounds: Rectangle

Dies Rectangle stellt die Grenzen des Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

backColor: Color

Die Color anwendung auf den bereich dargestellt durch bounds.

Ausnahmen

ArgumentNullException

dc ist null.

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 RenderText4 aus dem ereignishandler Paint des Formulars auf, und übergeben Sie e als PaintEventArgs.

private void RenderText4(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text.", this.Font,
        new Rectangle(10, 10, 70, 70), SystemColors.ControlText, 
        SystemColors.ControlDark);
}

Private Sub RenderText4(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text.", _
        Me.Font, New Rectangle(10, 10, 70, 70), _
        SystemColors.ControlText, SystemColors.ControlDark)

End Sub

Hinweise

Der backColor Parameter wird auf den Bereich innerhalb des bounds Parameters angewendet. font Ist backcolorbzw. ist bzwforecolor. ist null die EmptyMethode; die DrawText Methode zeichnet den Text in der Schriftart oder Farbe, die aktuell im durch den angegebenen Gerätekontext ausgewählt dcist. Wenn forecolor dies der Wert ist Transparent, wird der Text nicht gezeichnet.

Diese Methode führt zu Text, der horizontal und vertikal in dem durch den bounds Parameter angegebenen Rechteck zentriert ist. Um zu ändern, wie der Text gezeichnet wird, verwenden Sie eine Version davon, die DrawText einen TextFormatFlags Parametertyp verwendet.

Gilt für:

DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Formatierungsanweisungen.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, flags As TextFormatFlags)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: String

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

pt: Point

Dies Point stellt die obere linke Ecke des gezeichneten Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags Werte.

Ausnahmen

ArgumentNullException

dc ist null.

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 RenderText5 aus dem ereignishandler Paint des Formulars auf, und übergeben Sie e als PaintEventArgs.

private void RenderText5(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Some text.",
        this.Font, new Point(10, 10), SystemColors.ControlText, TextFormatFlags.Bottom);
}

Private Sub RenderText5(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Some text.", _
    Me.Font, New Point(10, 10), SystemColors.ControlText, _
    TextFormatFlags.Bottom)

End Sub

Hinweise

Der backColor Parameter wird auf den Bereich innerhalb des bounds Parameters angewendet. Ist font oder ist forecolor oder nullColor.Empty , bzw. ist die Methode; die DrawText Methode zeichnet den Text in der Schriftart oder Farbe, die aktuell im durch den angegebenen Gerätekontext ausgewählt istdc. Wenn forecolor dies der Wert ist Transparent, wird der Text nicht gezeichnet.

Das TextRenderer Hinzufügen von Tabstopps zum gezeichneten Text wird nicht unterstützt, sie können jedoch vorhandene Tabstopps mithilfe der ExpandTabs Kennzeichnung erweitern.

Note

Gilt für:

DrawText(IDeviceContext, String, Font, Point, Color, Color)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text an der angegebenen Position unter Verwendung des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Hintergrundfarbe.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText(System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

public static void DrawText(System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, backColor As Color)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: String

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

pt: Point

Dies Point stellt die obere linke Ecke des gezeichneten Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

backColor: Color

Der Color auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

Ausnahmen

ArgumentNullException

dc ist null.

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 RenderText3 aus dem ereignishandler Paint des Formulars auf, und übergeben Sie e als PaintEventArgs.

private void RenderText3(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
        new Point(10, 10), Color.Red, Color.PowderBlue);
}

Private Sub RenderText3(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", Me.Font, _
        New Point(10, 10), Color.Red, Color.PowderBlue)

End Sub

Hinweise

Der backColor Parameter wird auf den rechteckigen Bereich angewendet, der den gezeichneten Text enthält. font Ist backcolorbzw. ist bzwforecolor. ist null die Color.EmptyMethode; die DrawText Methode zeichnet den Text in der Schriftart oder Farbe, die aktuell im durch den angegebenen Gerätekontext ausgewählt dcist. Wenn forecolor dies der Wert ist Transparent, wird der Text nicht gezeichnet.

Sie können ändern, wie der Text gezeichnet wird, indem Sie eine der DrawText Überladungen verwenden, die einen TextFormatFlags Parameter verwenden.

Note

Gilt für:

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe, der Hintergrundfarbe und der Formatierungsanweisungen.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: ReadOnlySpan<Char>

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

bounds: Rectangle

Dies Rectangle stellt die Grenzen des Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

backColor: Color

Der Color auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags Werte.

Ausnahmen

ArgumentNullException

dc ist null.

ArgumentOutOfRangeException

ModifyString ist festgelegt.

Gilt für:

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Hintergrundfarbe.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText(System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, backColor As Color)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: ReadOnlySpan<Char>

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

bounds: Rectangle

Dies Rectangle stellt die Grenzen des Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

backColor: Color

Der Color auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

Ausnahmen

ArgumentNullException

dc ist null.

Gilt für:

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Formatierungsanweisungen.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, flags As TextFormatFlags)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: ReadOnlySpan<Char>

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

pt: Point

Dies Point stellt die obere linke Ecke des gezeichneten Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags Werte.

Ausnahmen

ArgumentNullException

dc ist null.

ArgumentOutOfRangeException

ModifyString ist festgelegt.

Gilt für:

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text an der angegebenen Position unter Verwendung des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Hintergrundfarbe.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText(System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, backColor As Color)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: ReadOnlySpan<Char>

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

pt: Point

Dies Point stellt die obere linke Ecke des gezeichneten Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

backColor: Color

Der Color auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

Ausnahmen

ArgumentNullException

dc ist null.

Gilt für:

DrawText(IDeviceContext, String, Font, Rectangle, Color)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen unter Verwendung des angegebenen Gerätekontexts, der Schriftart und der Farbe.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor);

public static void DrawText(System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

public static void DrawText(System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: String

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

bounds: Rectangle

Dies Rectangle stellt die Grenzen des Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

Ausnahmen

ArgumentNullException

dc ist null.

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 RenderText2 aus dem ereignishandler Paint des Formulars auf, und übergeben Sie e als PaintEventArgs.

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

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

End Sub

Hinweise

Ist font oder ist forecolor oder nullColor.Empty , bzw. ist die Methode; die DrawText Methode zeichnet den Text in der Schriftart oder Farbe, die aktuell im durch den angegebenen Gerätekontext ausgewählt istdc. Wenn forecolor dies der Wert ist Transparent, wird der Text nicht gezeichnet.

Weitere Informationen

IDeviceContext

Gilt für:

DrawText(IDeviceContext, String, Font, Point, Color)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text an der angegebenen Position mithilfe des angegebenen Gerätekontexts, der Schriftart und der Farbe.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor);

public static void DrawText(System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor);

public static void DrawText(System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: String

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

pt: Point

Dies Point stellt die obere linke Ecke des gezeichneten Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

Ausnahmen

ArgumentNullException

dc ist null.

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

Sie können ändern, wie der Text gezeichnet wird, indem Sie eine der DrawText Überladungen verwenden, die einen TextFormatFlags Parameter verwenden.

Wenn font dies der Wert ist nullforecolor, Color.Empty zeichnet die DrawText Methode den Text in der Schriftart oder Farbe, die aktuell im durch dcden angegebenen Gerätekontext ausgewählt ist. Wenn forecolor dies der Wert ist Transparent, wird der Text nicht gezeichnet.

Note

Weitere Informationen

IDeviceContext

Gilt für:

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen unter Verwendung des angegebenen Gerätekontexts, der Schriftart und der Farbe.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor);

public static void DrawText(System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: ReadOnlySpan<Char>

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

bounds: Rectangle

Dies Rectangle stellt die Grenzen des Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

Ausnahmen

ArgumentNullException

dc ist null.

Gilt für:

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Quelle:: TextRenderer.cs

Zeichnet den angegebenen Text innerhalb der angegebenen Grenzen mithilfe des angegebenen Gerätekontexts, der Schriftart, der Farbe und der Formatierungsanweisungen.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText(System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, flags As TextFormatFlags)

Parameter

dc: IDeviceContext

Der Gerätekontext, in dem der Text gezeichnet werden soll.

text: ReadOnlySpan<Char>

Der zu zeichnende Text.

font: Font

Der Font auf den gezeichneten Text angewendet werden soll.

bounds: Rectangle

Dies Rectangle stellt die Grenzen des Texts dar.

foreColor: Color

Der Color auf den gezeichneten Text angewendet werden soll.

flags: TextFormatFlags

Eine bitweise Kombination der TextFormatFlags Werte.

Ausnahmen

ArgumentNullException

dc ist null.

ArgumentOutOfRangeException

ModifyString ist festgelegt.

Gilt für:

Feedback

War diese Seite hilfreich?