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 Forms列印。請改用 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

Color，要套用至以 bounds 表示的區域。

flags: TextFormatFlags

TextFormatFlags 值的位元組合。

例外狀況

ArgumentNullException

dc 為 null。

範例

下列程式碼範例會示範如何使用 DrawText 方法。若要執行此範例，請將程式碼貼到 Windows Form 中，並從表單的 Paint 事件處理常式呼叫 RenderText8 ，並傳遞 e 為 PaintEventArgs 。

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 區域：如果 font 或 forecolorbackcolor 為 null 或 Empty ， DrawText 則方法會分別在指定的 dc 裝置內容中選取的字型或色彩中繪製文字。如果為 forecolorTransparent ，則不會繪製文字。

您可以使用其中一個採用 DrawText 參數的 TextFormatFlags 多載，管理文字的繪製方式。例如，TextRenderer 的預設行為是將邊框距離加入至已繪製之文字的週框 (Bounding Rectangle)，以容納突出 (Overhanging) 的圖像 (Glyph)。如果您需要繪製一行文字而不含這些額外空格，則應該使用會採用 DrawText 和 MeasureText 參數的 Size 和 TextFormatFlags 版本。如需範例，請參閱 MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)。

類別所提供的 TextRenderer 文字轉譯是以 GDI 文字轉譯為基礎，不支援從Windows Forms列印。請改用 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 Form 中，並從表單的 Paint 事件處理常式呼叫 RenderText7 ，並傳遞 e 為 PaintEventArgs 。

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 或為 null 或 Emptyforecolor ， DrawText 則方法會分別繪製目前在所指定 dc 裝置內容中選取的字型或色彩中的文字。如果為 forecolorTransparent ，則不會繪製文字。

類別所提供的 TextRenderer 文字轉譯是以 GDI 文字轉譯為基礎，不支援從Windows Forms列印。請改用 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 Form 中，並從表單的 Paint 事件處理常式呼叫 RenderText6 ，並傳遞 e 為 PaintEventArgs 。

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 或為 null 或 Emptycolor ， DrawText 則方法會分別繪製目前在所指定 dc 裝置內容中選取的字型或色彩中的文字。如果為 forecolorTransparent ，則不會繪製文字。

類別所提供的 TextRenderer 文字轉譯是以 GDI 文字轉譯為基礎，不支援從Windows Forms列印。請改用 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

Color，要套用至以 bounds 表示的區域。

例外狀況

ArgumentNullException

dc 為 null。

範例

下列程式碼範例會示範如何使用 DrawText 方法。若要執行此範例，請將程式碼貼到 Windows Form 中，並從表單的 Paint 事件處理常式呼叫 RenderText4 ，並傳遞 e 為 PaintEventArgs 。

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 ，則為或 Emptynullforecolor ，則 DrawText 方法會繪製目前在所指定 dc 裝置內容中選取的字型或色彩中的文字。如果為 forecolorTransparent ，則不會繪製文字。

這個方法會產生水準和垂直置中于參數所 bounds 指定矩形中的文字。若要變更文字的繪製方式，請使用採用參數類型的版本 DrawText TextFormatFlags 。

類別所提供的 TextRenderer 文字轉譯是以 GDI 文字轉譯為基礎，不支援從Windows Forms列印。請改用 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 Form 中，並從表單的 Paint 事件處理常式呼叫 RenderText5 ，並傳遞 e 為 PaintEventArgs 。

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 或為 null 或 Color.Emptyforecolor ， DrawText 則方法會分別繪製目前在所指定 dc 裝置內容中選取的字型或色彩中的文字。如果為 forecolorTransparent ，則不會繪製文字。

類別所提供的 TextRenderer 文字轉譯是以 GDI 文字轉譯為基礎，不支援從Windows Forms列印。請改用 DrawString 類別的方法 Graphics 。

TextRenderer不支援將定位停駐點新增至繪製的文字，不過您可以使用旗標展開現有的定位停駐點 ExpandTabs 。

注意

適用於

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 Form 中，並從表單的 Paint 事件處理常式呼叫 RenderText3 ，並傳遞 e 為 PaintEventArgs 。

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 ，則為或 Color.Emptynullforecolor ，則 DrawText 方法會繪製目前在所指定 dc 裝置內容中選取的字型或色彩中的文字。如果為 forecolorTransparent ，則不會繪製文字。

您可以使用其中一個採用 DrawText 參數的 TextFormatFlags 多載，管理文字的繪製方式。

類別所提供的 TextRenderer 文字轉譯是以 GDI 文字轉譯為基礎，不支援從Windows Forms列印。請改用 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 Form 中，並從表單的事件處理常式呼叫 RenderText2 ，並 e 傳遞為 PaintEventArgs 。 Paint

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 或分別為 null 或 Color.Emptyforecolor ，則 DrawText 方法會繪製目前在所 dc 指定裝置內容中選取的字型或色彩中的文字。如果 forecolor 為 Transparent ，則不會繪製文字。

這個方法會導致文字水準和垂直置中于參數所 bounds 指定的矩形中。若要變更文字的繪製方式，請使用採用 TextFormatFlags 參數類型的版本 DrawText 。

類別所提供的 TextRenderer 文字轉譯是以 GDI 文字轉譯為基礎，不支援從Windows Forms列印。請改用 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 Form 中，並從表單的事件處理常式呼叫 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

備註

您可以使用其中一個採用 DrawText 參數的 TextFormatFlags 多載，管理文字的繪製方式。

如果為 nullfont 或 forecolor 為 Color.Empty ，則 DrawText 方法會以目前在所 dc 指定的裝置內容中選取的字型或色彩繪製文字。如果 forecolor 為 Transparent ，則不會繪製文字。

類別所提供的 TextRenderer 文字轉譯是以 GDI 文字轉譯為基礎，不支援從Windows Forms列印。請改用 DrawString 類別的 Graphics 方法。

注意

指定 DrawText 為繪製文字左上角的方法 Point ，無法在 Windows 2000 上正確呈現。如果您的應用程式適用于執行 Windows 2000 的機器，您應該使用其中一種方法 DrawText 來指定 Rectangle 繪製文字界限的。

另請參閱

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)