TextRenderer.DrawText 方法

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)

参数

例外

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)

参数

例外

示例

下面的代码示例演示如何使用 DrawText 方法。 若要运行此示例，请将代码粘贴到 Windows 窗体中，并从窗体的Paint事件处理程序调用RenderText8，作为 ePaintEventArgs传递。

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

注解

参数backcolor将分别应用于 参数.中的bounds区域，forecolor或 fontbackcolor 为 null 或 Empty;DrawText该方法将使用指定的dc设备上下文中当前选择的字体或颜色绘制文本。 如果 forecolor 为 Transparent，则不会绘制文本。

您可以通过使用带有 DrawText 参数的 TextFormatFlags 重载之一，控制文本的绘制方式。 例如，TextRenderer 的默认行为是向所绘制文本的边框添加空白以符合延伸标志符号。 如果绘制一行文本时不需要这些额外空白，您应当使用带有 DrawText 和 MeasureText 参数的 Size 和 TextFormatFlags 版本。 有关示例，请参见 MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)。

类提供TextRenderer的文本呈现基于 GDI 文本呈现，不支持从Windows 窗体打印。 请改用 DrawString 类的 Graphics 方法。

TextRenderer 不支持向绘制的文本添加制表位，虽然可以使用 ExpandTabs 标志扩展现有制表位。

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)

参数

例外

示例

下面的代码示例演示如何使用 DrawText 方法。 若要运行此示例，请将代码粘贴到 Windows 窗体中，并从窗体的Paint事件处理程序调用RenderText7，作为 ePaintEventArgs传递。

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

注解

参数 backcolor 应用于包含绘制文本的矩形区域。 如果 font 或 forecolor 是 null 或 Empty，则分别; DrawText 方法将使用 指定的 dc设备上下文中当前选择的字体或颜色绘制文本。 如果 forecolor 为 Transparent，则不会绘制文本。

您可以通过使用带有 DrawText 参数的 TextFormatFlags 重载之一，控制文本的绘制方式。 例如，TextRenderer 的默认行为是向所绘制文本的边框添加空白以符合延伸标志符号。 如果绘制一行文本时不需要这些额外空白，您应当使用带有 DrawText 和 MeasureText 参数的 Size 和 TextFormatFlags 版本。 有关示例，请参见 MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)。

类提供TextRenderer的文本呈现基于 GDI 文本呈现，不支持从Windows 窗体打印。 请改用 DrawString 类的 Graphics 方法。

TextRenderer 不支持向绘制的文本添加制表位，虽然可以使用 ExpandTabs 标志扩展现有制表位。

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)

参数

例外

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)

参数

例外

示例

下面的代码示例演示如何使用 DrawText 方法。 若要运行此示例，请将代码粘贴到 Windows 窗体中，并从窗体的Paint事件处理程序调用RenderText6，作为 ePaintEventArgs传递。

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

注解

如果 font 或 color 分别为 null 或 Empty，则 DrawText 该方法将使用指定的 dc设备上下文中当前所选的字体或颜色绘制文本。 如果 forecolor 为 Transparent，则不会绘制文本。

您可以通过使用带有 DrawText 参数的 TextFormatFlags 重载之一，控制文本的绘制方式。 例如，TextRenderer 的默认行为是向所绘制文本的边框添加空白以符合延伸标志符号。 如果绘制一行文本时不需要这些额外空白，您应当使用带有 DrawText 和 MeasureText 参数的 Size 和 TextFormatFlags 版本。 有关示例，请参见 MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)。

类提供TextRenderer的文本呈现基于 GDI 文本呈现，不支持从Windows 窗体打印。 请改用 DrawString 类的 Graphics 方法。

TextRenderer 不支持向绘制的文本添加制表位，虽然可以使用 ExpandTabs 标志扩展现有制表位。

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)

参数

例外

示例

下面的代码示例演示如何使用 DrawText 方法。 若要运行此示例，请将代码粘贴到 Windows 窗体中，并从窗体的 事件处理程序调用 RenderText4 ，并e作为 PaintEventArgs传递。Paint

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

注解

参数 backColor 应用于 参数中的 bounds 区域。 如果 font、 backcolor 或 forecolor 分别为 null 或 Empty，则 DrawText 该方法将以 指定的 dc设备上下文中当前所选的字体或颜色绘制文本。 如果 forecolor 为 Transparent，则不会绘制文本。

此方法将导致文本在 参数指定的 bounds 矩形中水平和垂直居中。 若要更改文本的绘制方式，请使用采用TextFormatFlags参数类型的 的版本DrawText。

类提供TextRenderer的文本呈现基于 GDI 文本呈现，不支持从Windows 窗体打印。 请改用 DrawString 类的 Graphics 方法。

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)

参数

例外

示例

下面的代码示例演示如何使用 DrawText 方法。 若要运行此示例，请将代码粘贴到 Windows 窗体中，并从窗体的 事件处理程序调用 RenderText5 ，并e作为 PaintEventArgs传递。Paint

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

注解

您可以通过使用带有 DrawText 参数的 TextFormatFlags 重载之一，控制文本的绘制方式。 例如，TextRenderer 的默认行为是向所绘制文本的边框添加空白以符合延伸标志符号。 如果绘制一行文本时不需要这些额外空白，您应当使用带有 DrawText 和 MeasureText 参数的 Size 和 TextFormatFlags 版本。 有关示例，请参见 MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)。

参数 backColor 应用于 参数中的 bounds 区域。 如果 font 或 forecolor 分别为 null 或 Color.Empty，则 DrawText 该方法将使用指定的 dc设备上下文中当前所选的字体或颜色绘制文本。 如果 forecolor 为 Transparent，则不会绘制文本。

类提供TextRenderer的文本呈现基于 GDI 文本呈现，不支持从Windows 窗体打印。 请改用 DrawString 类的 Graphics 方法。

TextRenderer 不支持向绘制的文本添加制表位，虽然可以使用 ExpandTabs 标志扩展现有制表位。

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)

参数

例外

示例

下面的代码示例演示如何使用 DrawText 方法。 若要运行此示例，请将代码粘贴到 Windows 窗体中，并从窗体的 事件处理程序调用 RenderText3 ，并e作为 PaintEventArgs传递。Paint

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

注解

参数 backColor 应用于包含绘制文本的矩形区域。 如果 font、 backcolor 或 forecolor 分别为 null 或 Color.Empty，则 DrawText 该方法将以 指定的 dc设备上下文中当前所选的字体或颜色绘制文本。 如果 forecolor 为 Transparent，则不会绘制文本。

您可以通过使用带有 DrawText 参数的 TextFormatFlags 重载之一，控制文本的绘制方式。

类提供TextRenderer的文本呈现基于 GDI 文本呈现，不支持从Windows 窗体打印。 请改用 DrawString 类的 Graphics 方法。

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)

参数

例外

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)

参数

例外

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)

参数

例外

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)

参数

例外

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)

参数

例外

示例

下面的代码示例演示如何使用 DrawText 方法。 若要运行此示例，请将代码粘贴到 Windows 窗体中，并从窗体的Paint事件处理程序调用RenderText2，作为 ePaintEventArgs传递。

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

注解

如果 font 或 forecolor 是 null 或 Color.Empty，则分别; DrawText 方法将使用 指定的 dc设备上下文中当前选择的字体或颜色绘制文本。 如果 forecolor 为 Transparent，则不会绘制文本。

此方法将导致文本在 参数指定的 bounds 矩形中水平和垂直居中。 若要更改文本的绘制方式，请使用采用TextFormatFlags参数类型的 的版本DrawText。

类提供TextRenderer的文本呈现基于 GDI 文本呈现，不支持从Windows 窗体打印。 请改用 DrawString 类的 Graphics 方法。

另请参阅

• IDeviceContext

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)

参数

例外

示例

下面的代码示例演示如何使用 DrawText 方法。 若要运行此示例，请将代码粘贴到 Windows 窗体中，并从窗体的Paint事件处理程序调用RenderText1，作为 ePaintEventArgs传递。

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

注解

您可以通过使用带有 DrawText 参数的 TextFormatFlags 重载之一，控制文本的绘制方式。

如果 font 为 null 或 forecolor 为 Color.Empty，则 DrawText 方法将以 指定的 dc设备上下文中当前选择的字体或颜色绘制文本。 如果 forecolor 为 Transparent，则不会绘制文本。

类提供TextRenderer的文本呈现基于 GDI 文本呈现，不支持从Windows 窗体打印。 请改用 DrawString 类的 Graphics 方法。

另请参阅

• IDeviceContext

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)

参数

例外

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)

参数

例外