TextRenderer.DrawText Methode
Definition
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 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- ReadOnlySpan<Char>
Der zu zeichnende Text.
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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- String
Der zu zeichnende Text.
- 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 font
forecolor
oder null
backcolor
ist oder bzwEmpty. angewendet. Die DrawText -Methode zeichnet den Text in der Schriftart oder Farbe, die derzeit im durch angegebenen Gerätekontext ausgewählt dc
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.
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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- String
Der zu zeichnende Text.
- 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 forecolor
null
bzw Empty. ist, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit in dem von dc
angegebenen 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- ReadOnlySpan<Char>
Der zu zeichnende Text.
- 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
.
ModifyString ist festgelegt.
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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- String
Der zu zeichnende Text.
- 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- String
Der zu zeichnende Text.
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 font
bzw backcolor
forecolor
. oder oder Emptyistnull
, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit im von dc
angegebenen 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- String
Der zu zeichnende Text.
- 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- String
Der zu zeichnende Text.
- 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 font
bzw backcolor
forecolor
. oder oder Color.Emptyistnull
, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit im von dc
angegebenen 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- ReadOnlySpan<Char>
Der zu zeichnende Text.
- 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
.
ModifyString ist festgelegt.
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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- ReadOnlySpan<Char>
Der zu zeichnende Text.
- 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- ReadOnlySpan<Char>
Der zu zeichnende Text.
- flags
- TextFormatFlags
Eine bitweise Kombination der TextFormatFlags-Werte.
Ausnahmen
dc
ist null
.
ModifyString ist festgelegt.
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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- ReadOnlySpan<Char>
Der zu zeichnende Text.
- 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- String
Der zu zeichnende Text.
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 forecolor
null
bzw Color.Empty. ist, zeichnet die DrawText -Methode den Text in der Schriftart oder Farbe, die derzeit in dem von dc
angegebenen 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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- String
Der zu zeichnende Text.
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 dc
null
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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- ReadOnlySpan<Char>
Der zu zeichnende Text.
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
Der Gerätekontext, in dem der Text gezeichnet werden soll.
- text
- ReadOnlySpan<Char>
Der zu zeichnende Text.
- flags
- TextFormatFlags
Eine bitweise Kombination der TextFormatFlags-Werte.
Ausnahmen
dc
ist null
.
ModifyString ist festgelegt.