TextRenderer 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

提供用于测量和呈现文本的方法。 此类不能被继承。

public ref class TextRenderer abstract sealed

public static class TextRenderer

type TextRenderer = class

Public Class TextRenderer

继承

Object

TextRenderer

示例

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

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

注解

类 TextRenderer 提供了一组 static 可用于在 Windows 窗体控件上测量和绘制文本的方法。

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

注意

TextRenderer 的 DrawText 方法不支持打印。 应始终使用 DrawString 类的方法 Graphics 。

方法

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	使用指定的设备上下文、字体和颜色在指定位置绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	使用指定的设备上下文、字体、颜色和背景色在指定位置绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色、背景色和格式说明在指定位置绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色和格式说明在指定位置绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	使用指定的设备上下文、字体和颜色在指定界限中绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	使用指定的设备上下文、字体、颜色和背景色在指定界限中绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色、背景色和格式说明在指定界限中绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色和格式说明在指定界限中绘制指定文本。
DrawText(IDeviceContext, String, Font, Point, Color)	使用指定的设备上下文、字体和颜色在指定位置绘制指定文本。
DrawText(IDeviceContext, String, Font, Point, Color, Color)	使用指定的设备上下文、字体、颜色和背景色在指定位置绘制指定文本。
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色、背景色和格式说明在指定位置绘制指定文本。
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色和格式说明在指定位置绘制指定文本。
DrawText(IDeviceContext, String, Font, Rectangle, Color)	使用指定的设备上下文、字体和颜色在指定界限中绘制指定文本。
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	使用指定的设备上下文、字体、颜色和背景色在指定界限中绘制指定文本。
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色、背景色和格式说明在指定界限中绘制指定文本。
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色和格式说明在指定界限中绘制指定文本。
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font)	提供在指定设备上下文中使用指定字体绘制的指定文本的尺寸（以像素为单位）。
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size)	提供在使用指定尺寸创建文本的初始边框时，在指定的设备上下文中采用指定字体绘制的指定文本的尺寸（以像素为单位）。
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	提供使用指定尺寸创建文本初始边框时，使用指定的设备上下文、字体和格式说明所绘制的指定文本的尺寸（以像素为单位）。
MeasureText(IDeviceContext, String, Font)	提供在指定设备上下文中使用指定字体绘制的指定文本的尺寸（以像素为单位）。
MeasureText(IDeviceContext, String, Font, Size)	提供在使用指定尺寸创建文本的初始边框时，在指定的设备上下文中采用指定字体绘制的指定文本的尺寸（以像素为单位）。
MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)	提供使用指定尺寸创建文本初始边框时，使用指定的设备上下文、字体和格式说明所绘制的指定文本的尺寸（以像素为单位）。
MeasureText(ReadOnlySpan<Char>, Font)	在使用指定字体绘制时，提供指定文本的尺寸（以像素为单位）。
MeasureText(ReadOnlySpan<Char>, Font, Size)	提供在使用指定尺寸创建初始边框时，采用指定字体绘制的指定文本的尺寸（以像素为单位）。
MeasureText(ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	提供在使用指定大小创建文本初始边框时，使用指定的字体和格式说明绘制的指定文本的大小（以像素为单位）。
MeasureText(String, Font)	在使用指定字体绘制时，提供指定文本的尺寸（以像素为单位）。
MeasureText(String, Font, Size)	提供在使用指定尺寸创建初始边框时，采用指定字体绘制的指定文本的尺寸（以像素为单位）。
MeasureText(String, Font, Size, TextFormatFlags)	提供在使用指定大小创建文本初始边框时，使用指定的字体和格式说明绘制的指定文本的大小（以像素为单位）。