Freigeben über


TextRenderer.DrawText Methode

Definition

Zeichnet den angegebenen Text an der angegebenen Position und verwendet den angegebenen Gerätekontext, die angegebene Farbe und Schriftart.

Überlädt

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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, TextFormatFlags)

Zeichnet den angegebenen Text innerhalb der angegebenen Begrenzungen und verwendet dabei den angegebenen Gerätekontext, die angegebene Schriftart, Farbe und die angegebenen Formatierungsanweisungen.

Hinweise

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

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.

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, der auf den gezeichneten Text angewendet werden soll.

pt
Point

Der Point, der die obere linke Ecke des gezeichneten Texts angibt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

Ausnahmen

dc ist null.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

bounds
Rectangle

Das Rectangle, das die Begrenzungen des Texts darstellt.

foreColor
Color

Die Color, die auf den Text angewendet werden soll.

backColor
Color

Die Color, die auf den durch bounds dargestellten Bereich angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

Ausnahmen

dc ist null.

Beispiele

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

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 nullbackcolor ist oder bzwEmpty. angewendet. Die DrawText -Methode zeichnet den Text in der Schriftart oder Farbe, die derzeit im durch angegebenen Gerätekontext ausgewählt dcist. Wenn forecolor ist Transparent, wird der Text nicht gezeichnet.

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

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

TextRenderer unterstützt nicht das Hinzufügen von Tabstopps zum Zeichnen von Text, obwohl Sie vorhandene Tabstopps mithilfe des ExpandTabs-Flags erweitern können.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

pt
Point

Der Point, der die obere linke Ecke des gezeichneten Texts angibt.

foreColor
Color

Die Color, die auf den Text angewendet werden soll.

backColor
Color

Die Color, die auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

Ausnahmen

dc ist null.

Beispiele

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

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. Wenn font oder forecolornull bzw Empty. ist, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit in dem von dcangegebenen Gerätekontext ausgewählt ist. Wenn forecolor ist Transparent, wird der Text nicht gezeichnet.

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

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

TextRenderer unterstützt nicht das Hinzufügen von Tabstopps zum Zeichnen von Text, obwohl Sie vorhandene Tabstopps mithilfe des ExpandTabs-Flags erweitern können.

Hinweis

Die DrawText Methoden, die eine Point als obere linke Ecke des gezeichneten Texts angeben, werden unter Windows 2000 nicht ordnungsgemäß gerendert. Wenn Ihre Anwendung für die Verwendung auf Computern unter Windows 2000 vorgesehen ist, sollten Sie eine der Methoden verwenden, die DrawText eine Rectangle für die Grenzen des gezeichneten Texts angeben.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

pt
Point

Der Point, der die obere linke Ecke des gezeichneten Texts angibt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

backColor
Color

Die Color, die auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

Ausnahmen

dc ist null.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

bounds
Rectangle

Das Rectangle, das die Begrenzungen des Texts darstellt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

Ausnahmen

dc ist null.

Beispiele

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

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

Wenn font oder bzw color . ist null , Emptyzeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit im gerätespezifischen Kontext ausgewählt ist dc. Wenn forecolor ist Transparent, wird der Text nicht gezeichnet.

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

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

TextRenderer unterstützt nicht das Hinzufügen von Tabstopps zum Zeichnen von Text, obwohl Sie vorhandene Tabstopps mithilfe des ExpandTabs-Flags erweitern können.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

bounds
Rectangle

Das Rectangle, das die Begrenzungen des Texts darstellt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

backColor
Color

Die Color, die auf den durch bounds dargestellten Bereich angewendet werden soll.

Ausnahmen

dc ist null.

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 RenderText4 aus dem Ereignishandler des Formulars Paint auf, indem Sie als PaintEventArgsübergebene.

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. Wenn fontbzw backcolorforecolor. oder oder Emptyistnull, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit im von dcangegebenen Gerätekontext ausgewählt ist. Wenn forecolor ist Transparent, wird der Text nicht gezeichnet.

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

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

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

pt
Point

Der Point, der die obere linke Ecke des gezeichneten Texts angibt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

Ausnahmen

dc ist null.

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 RenderText5 aus dem Ereignishandler des Formulars Paint auf, indem Sie als PaintEventArgsübergebene.

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

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

Der backColor Parameter wird auf den Bereich innerhalb des bounds Parameters angewendet. Wenn font oder bzw forecolor . ist null , Color.Emptyzeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit im gerätespezifischen Kontext ausgewählt ist dc. Wenn forecolor ist Transparent, wird der Text nicht gezeichnet.

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

TextRenderer unterstützt nicht das Hinzufügen von Tabstopps zum Zeichnen von Text, obwohl Sie vorhandene Tabstopps mithilfe des ExpandTabs-Flags erweitern können.

Hinweis

Die DrawText Methoden, die eine Point als obere linke Ecke des gezeichneten Texts angeben, werden unter Windows 2000 nicht ordnungsgemäß gerendert. Wenn Ihre Anwendung für die Verwendung auf Computern mit Windows 2000 vorgesehen ist, sollten Sie eine der Methoden verwenden, die DrawText eine Rectangle für die Grenzen des gezeichneten Texts angeben.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

pt
Point

Der Point, der die obere linke Ecke des gezeichneten Texts angibt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

backColor
Color

Die Color, die auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

Ausnahmen

dc ist null.

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 RenderText3 aus dem Ereignishandler des Formulars Paint auf, indem Sie als PaintEventArgsübergebene.

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. Wenn fontbzw backcolorforecolor. oder oder Color.Emptyistnull, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit im von dcangegebenen Gerätekontext ausgewählt ist. Wenn forecolor ist Transparent, wird der Text nicht gezeichnet.

Wie der Text gezeichnet wird, können Sie mithilfe einer der Überladungen von DrawText beeinflussen, die einen TextFormatFlags-Parameter akzeptiert.

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

Hinweis

Die DrawText Methoden, die eine Point als obere linke Ecke des gezeichneten Texts angeben, werden unter Windows 2000 nicht ordnungsgemäß gerendert. Wenn Ihre Anwendung für die Verwendung auf Computern mit Windows 2000 vorgesehen ist, sollten Sie eine der Methoden verwenden, die DrawText eine Rectangle für die Grenzen des gezeichneten Texts angeben.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

bounds
Rectangle

Das Rectangle, das die Begrenzungen des Texts darstellt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

backColor
Color

Die Color, die auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

Ausnahmen

dc ist null.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

bounds
Rectangle

Das Rectangle, das die Begrenzungen des Texts darstellt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

backColor
Color

Die Color, die auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

Ausnahmen

dc ist null.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

pt
Point

Der Point, der die obere linke Ecke des gezeichneten Texts angibt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

Ausnahmen

dc ist null.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

pt
Point

Der Point, der die obere linke Ecke des gezeichneten Texts angibt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

backColor
Color

Die Color, die auf den Hintergrundbereich des gezeichneten Texts angewendet werden soll.

Ausnahmen

dc ist null.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

bounds
Rectangle

Das Rectangle, das die Begrenzungen des Texts darstellt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

Ausnahmen

dc ist null.

Beispiele

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

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

Wenn font oder forecolornull bzw Color.Empty. ist, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit in dem von dcangegebenen Gerätekontext ausgewählt ist. Wenn forecolor ist Transparent, wird der Text nicht gezeichnet.

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

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

Weitere Informationen

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

pt
Point

Der Point, der die obere linke Ecke des gezeichneten Texts angibt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

Ausnahmen

dc ist null.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die DrawText-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Windows Form-Objekt ein, und rufen RenderText1 Sie 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

Wie der Text gezeichnet wird, können Sie mithilfe einer der Überladungen von DrawText beeinflussen, die einen TextFormatFlags-Parameter akzeptiert.

Wenn font oder forecolor istColor.Empty, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit im durch dcnull angegebenen Gerätekontext ausgewählt ist. Wenn forecolor ist Transparent, wird der Text nicht gezeichnet.

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

Hinweis

Die DrawText Methoden, die eine Point als obere linke Ecke des gezeichneten Texts angeben, werden unter Windows 2000 nicht ordnungsgemäß gerendert. Wenn Ihre Anwendung für die Verwendung auf Computern unter Windows 2000 vorgesehen ist, sollten Sie eine der Methoden verwenden, die DrawText eine Rectangle für die Grenzen des gezeichneten Texts angeben.

Weitere Informationen

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

bounds
Rectangle

Das Rectangle, das die Begrenzungen des Texts darstellt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

Ausnahmen

dc ist null.

Gilt für:

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.

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, der auf den gezeichneten Text angewendet werden soll.

bounds
Rectangle

Das Rectangle, das die Begrenzungen des Texts darstellt.

foreColor
Color

Der Color, der auf den gezeichneten Text angewendet werden soll.

flags
TextFormatFlags

Eine bitweise Kombination der TextFormatFlags-Werte.

Ausnahmen

dc ist null.

Gilt für: