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し、をとしてPaintEventArgs渡eします。

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、またはが null または Emptybackcolor の場合fontforecolor、それぞれパラメーター.内boundsの領域にDrawText適用されます。メソッドは、でdc指定されたデバイスコンテキストで現在選択されているフォントまたは色でテキストを描画します。が Transparentの場合forecolor、テキストは描画されません。

DrawText パラメーターを受け取る TextFormatFlags オーバーロードの 1 つを使用して、テキストの描画方法を操作できます。たとえば、TextRenderer の既定の動作では、グリフの突出部が収まるように、描画されるテキストの外接する四角形にパディングが追加されます。この余分な領域なしでテキストの行を描画する必要がある場合は、DrawText パラメーターと MeasureText パラメーターを受け取るバージョンの Size および TextFormatFlags を使用する必要があります。例については、「MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)」を参照してください。

ExpandTabs フラグを使用して既存のタブストップを拡張することはできますが、TextRenderer は、描画されたテキストへのタブストップの追加をサポートしていません。

適用対象

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し、をとしてPaintEventArgs渡eします。

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 、描画されたテキストを含む四角形の領域に適用されます。またはがまたはの場合、メソッドは、でdc指定されたデバイスコンテキストで現在選択されているフォントまたは色でテキストを描画します。fontDrawText Emptynullforecolor が Transparentの場合forecolor、テキストは描画されません。

注意

描画されたテキストの左上隅としてをPoint指定するメソッドはDrawText、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し、をとしてPaintEventArgs渡eします。

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、DrawTextメソッドは、で指定されたdcデバイスコンテキストで現在選択されているフォントまたは色でテキストを描画します。Emptynullcolor が Transparentの場合forecolor、テキストは描画されません。

クラスによって提供されるTextRendererテキストレンダリングは GDI テキストレンダリングに基づいており、Windows フォームからの印刷ではサポートされていません。代わりに、クラスの DrawString メソッドを使用します Graphics 。

適用対象

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 フォームに貼り付け、フォームのPaintイベントハンドラーからを呼び出RenderText4し、をとしてPaintEventArgs渡eします。

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 適用されます。のbackcolor場合、または forecolor が null または DrawText Emptyの場合font、メソッドは、で指定されたdcデバイスコンテキストで現在選択されているフォントまたは色でテキストを描画します。が Transparentの場合forecolor、テキストは描画されません。

このメソッドは、パラメーターで指定された四角形の水平方向と垂直方向の中央にテキストが bounds 生成されます。テキストの描画方法を変更するには、パラメーター型を受け取るの DrawText バージョンを TextFormatFlags 使用します。

適用対象

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 フォームに貼り付け、フォームのPaintイベントハンドラーからを呼び出RenderText5し、をとしてPaintEventArgs渡eします。

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、DrawTextメソッドは、で指定されたdcデバイスコンテキストで現在選択されているフォントまたは色でテキストを描画します。Color.Emptynullforecolor が Transparentの場合forecolor、テキストは描画されません。

注意

描画されたテキストの左上隅としてをPoint指定するメソッドはDrawText、Windows 2000 で正しくレンダリングされません。アプリケーションが Windows 2000 を実行しているマシンで使用することを目的としている場合は、描画されたテキストの DrawText 境界にを指定 Rectangle するメソッドのいずれかを使用する必要があります。

適用対象

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 フォームに貼り付け、フォームのPaintイベントハンドラーからを呼び出RenderText3し、をとしてPaintEventArgs渡eします。

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 、描画されたテキストを含む四角形の領域に適用されます。のbackcolor場合、または forecolor が null または DrawText Color.Emptyの場合font、メソッドは、で指定されたdcデバイスコンテキストで現在選択されているフォントまたは色でテキストを描画します。が Transparentの場合forecolor、テキストは描画されません。

DrawText パラメーターを受け取る TextFormatFlags オーバーロードの 1 つを使用して、テキストの描画方法を操作できます。

注意

適用対象

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し、をとしてPaintEventArgs渡eします。

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

注釈

またはがまたはの場合、メソッドは、でdc指定されたデバイスコンテキストで現在選択されているフォントまたは色でテキストを描画します。fontDrawText Color.Emptynullforecolor が Transparentの場合forecolor、テキストは描画されません。

このメソッドでは、パラメーターで指定された四角形の水平方向と垂直方向の中央にテキストが bounds 生成されます。テキストの描画方法を変更するには、パラメーター型を受け取るの DrawText バージョンを TextFormatFlags 使用します。

こちらもご覧ください

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し、をとしてPaintEventArgs渡eします。

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 オーバーロードの 1 つを使用して、テキストの描画方法を操作できます。

が null または forecolor のColor.Empty場合font、DrawTextメソッドは、で指定されたdcデバイスコンテキストで現在選択されているフォントまたは色でテキストを描画します。が Transparentの場合forecolor、テキストは描画されません。

注意

こちらもご覧ください

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)

パラメーター

dc: IDeviceContext

テキストを描画するデバイスコンテキスト。

text: ReadOnlySpan<Char>

描画するテキスト。

font: Font

描画するテキストに適用される Font。

bounds: Rectangle

テキストの境界を表す Rectangle。

foreColor: Color

描画するテキストに適用される Color。

flags: TextFormatFlags

TextFormatFlags 値のビットごとの組み合わせ。

例外

ArgumentNullException

dc が nullです。

ArgumentOutOfRangeException

ModifyString が設定されます。

適用対象

次の方法で共有

TextRenderer.DrawText メソッド

定義

オーバーロード

注釈

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)