TextRenderer.DrawText 方法

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

使用指定的设备上下文、颜色和字体在指定位置绘制指定文本。

重载

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	使用指定的设备上下文、字体和颜色在指定位置绘制指定文本。
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色、背景色和格式说明在指定界限中绘制指定文本。
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色、背景色和格式说明在指定位置绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色、背景色和格式说明在指定位置绘制指定文本。
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色和格式说明在指定界限中绘制指定文本。
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	使用指定的设备上下文、字体、颜色和背景色在指定界限中绘制指定文本。
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色和格式说明在指定位置绘制指定文本。
DrawText(IDeviceContext, String, Font, Point, Color, Color)	使用指定的设备上下文、字体、颜色和背景色在指定位置绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色、背景色和格式说明在指定界限中绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	使用指定的设备上下文、字体、颜色和背景色在指定界限中绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色和格式说明在指定位置绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	使用指定的设备上下文、字体、颜色和背景色在指定位置绘制指定文本。
DrawText(IDeviceContext, String, Font, Rectangle, Color)	使用指定的设备上下文、字体和颜色在指定界限中绘制指定文本。
DrawText(IDeviceContext, String, Font, Point, Color)	使用指定的设备上下文、字体和颜色在指定位置绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	使用指定的设备上下文、字体和颜色在指定界限中绘制指定文本。
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	使用指定的设备上下文、字体、颜色和格式说明在指定界限中绘制指定文本。

注解

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

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

使用指定的设备上下文、字体和颜色在指定位置绘制指定文本。

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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: ReadOnlySpan<Char>

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

pt: Point

表示所绘制文本左上角的 Point。

foreColor: Color

要应用于所绘制文本的 Color。

例外

ArgumentNullException

dc 为 null。

适用于

DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, 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::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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: String

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

bounds: Rectangle

表示文本界限的 Rectangle。

foreColor: Color

要应用于文本的 Color。

backColor: Color

要应用于 bounds 所表示区域的 Color。

flags: TextFormatFlags

TextFormatFlags 值的按位组合。

例外

ArgumentNullException

dc 为 null。

示例

下面的代码示例演示如何使用 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 标志扩展现有制表位。

适用于

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

使用指定的设备上下文、字体、颜色、背景色和格式说明在指定位置绘制指定文本。

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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: String

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

pt: Point

表示所绘制文本左上角的 Point。

foreColor: Color

要应用于文本的 Color。

backColor: Color

要应用于所绘制文本的背景区域的 Color。

flags: TextFormatFlags

TextFormatFlags 值的按位组合。

例外

ArgumentNullException

dc 为 null。

示例

下面的代码示例演示如何使用 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，则不会绘制文本。

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

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

注意

DrawText将指定Point为绘制文本左上角的方法在 Windows 2000 上无法正确呈现。如果应用程序打算在运行 Windows 2000 的计算机上使用，则应使用为绘制文本边界指定的方法之一DrawText Rectangle。

适用于

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, 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, 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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: ReadOnlySpan<Char>

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

pt: Point

表示所绘制文本左上角的 Point。

foreColor: Color

要应用于所绘制文本的 Color。

backColor: Color

要应用于所绘制文本的背景区域的 Color。

flags: TextFormatFlags

TextFormatFlags 值的按位组合。

例外

ArgumentNullException

dc 上声明的默认值为 null。

ArgumentOutOfRangeException

已设置 ModifyString。

适用于

DrawText(IDeviceContext, String, Font, Rectangle, Color, 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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: String

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

bounds: Rectangle

表示文本界限的 Rectangle。

foreColor: Color

要应用于所绘制文本的 Color。

flags: TextFormatFlags

TextFormatFlags 值的按位组合。

例外

ArgumentNullException

dc 为 null。

示例

下面的代码示例演示如何使用 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，则不会绘制文本。

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

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

适用于

DrawText(IDeviceContext, String, Font, Rectangle, Color, 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);

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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: String

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

bounds: Rectangle

表示文本界限的 Rectangle。

foreColor: Color

要应用于所绘制文本的 Color。

backColor: Color

要应用于 bounds 所表示区域的 Color。

例外

ArgumentNullException

dc 为 null。

示例

下面的代码示例演示如何使用 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 方法。

适用于

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

使用指定的设备上下文、字体、颜色和格式说明在指定位置绘制指定文本。

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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: String

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

pt: Point

表示所绘制文本左上角的 Point。

foreColor: Color

要应用于所绘制文本的 Color。

flags: TextFormatFlags

TextFormatFlags 值的按位组合。

例外

ArgumentNullException

dc 为 null。

示例

下面的代码示例演示如何使用 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

注解

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

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

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

注意

DrawText指定 Point 作为绘制文本左上角的方法在 Windows 2000 上无法正确呈现。如果应用程序打算在运行 Windows 2000 的计算机上使用，则应使用为所绘制文本的边界指定 Rectangle 的方法之一DrawText。

适用于

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

使用指定的设备上下文、字体、颜色和背景色在指定位置绘制指定文本。

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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: String

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

pt: Point

表示所绘制文本左上角的 Point。

foreColor: Color

要应用于所绘制文本的 Color。

backColor: Color

要应用于所绘制文本的背景区域的 Color。

例外

ArgumentNullException

dc 为 null。

示例

下面的代码示例演示如何使用 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 方法。

注意

适用于

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, 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, 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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: ReadOnlySpan<Char>

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

bounds: Rectangle

表示文本界限的 Rectangle。

foreColor: Color

要应用于所绘制文本的 Color。

backColor: Color

要应用于所绘制文本的背景区域的 Color。

flags: TextFormatFlags

TextFormatFlags 值的按位组合。

例外

ArgumentNullException

dc 为 null。

ArgumentOutOfRangeException

已设置 ModifyString。

适用于

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, 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::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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: ReadOnlySpan<Char>

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

bounds: Rectangle

表示文本界限的 Rectangle。

foreColor: Color

要应用于所绘制文本的 Color。

backColor: Color

要应用于所绘制文本的背景区域的 Color。

例外

ArgumentNullException

dc 上声明的默认值为 null。

适用于

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, 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::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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: ReadOnlySpan<Char>

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

pt: Point

表示所绘制文本左上角的 Point。

foreColor: Color

要应用于所绘制文本的 Color。

flags: TextFormatFlags

TextFormatFlags 值的按位组合。

例外

ArgumentNullException

dc 为 null。

ArgumentOutOfRangeException

已设置 ModifyString。

适用于

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, 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::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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: ReadOnlySpan<Char>

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

pt: Point

表示所绘制文本左上角的 Point。

foreColor: Color

要应用于所绘制文本的 Color。

backColor: Color

要应用于所绘制文本的背景区域的 Color。

例外

ArgumentNullException

dc 上声明的默认值为 null。

适用于

DrawText(IDeviceContext, String, Font, Rectangle, 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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: String

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

bounds: Rectangle

表示文本界限的 Rectangle。

foreColor: Color

要应用于所绘制文本的 Color。

例外

ArgumentNullException

dc 为 null。

示例

下面的代码示例演示如何使用 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

适用于

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

使用指定的设备上下文、字体和颜色在指定位置绘制指定文本。

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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: String

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

pt: Point

表示所绘制文本左上角的 Point。

foreColor: Color

要应用于所绘制文本的 Color。

例外

ArgumentNullException

dc 为 null。

示例

下面的代码示例演示如何使用 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

适用于

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

使用指定的设备上下文、字体和颜色在指定界限中绘制指定文本。

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)

参数

dc: IDeviceContext

绘制文本所使用的设备上下文。

text: ReadOnlySpan<Char>

要绘制的文本。

font: Font

要应用于所绘制文本的 Font。

bounds: Rectangle

表示文本界限的 Rectangle。

foreColor: Color

要应用于所绘制文本的 Color。

例外

ArgumentNullException

dc 为 null。

适用于

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, 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::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)