次の方法で共有


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)

指定したテキストを、指定したデバイス コンテキスト、フォント、および色を使用して、指定した境界内に描画します。

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

例外

dcnullです。

適用対象

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 値のビットごとの組み合わせ。

例外

dcnullです。

次のコード例は、DrawText メソッドの使用方法を示します。 この例を実行するには、コードを Windows フォームに貼り付け、フォームのPaintイベント ハンドラーから を呼び出RenderText8し、 を としてPaintEventArgseします。

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)」を参照してください。

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

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 値のビットごとの組み合わせ。

例外

dcnullです。

次のコード例は、DrawText メソッドの使用方法を示します。 この例を実行するには、コードを Windows フォームに貼り付け、フォームのPaintイベント ハンドラーから を呼び出RenderText7し、 を としてPaintEventArgseします。

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

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

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

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

注意

描画されたテキストの左上隅として を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 値のビットごとの組み合わせ。

例外

dcnull です。

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 値のビットごとの組み合わせ。

例外

dcnullです。

次のコード例は、DrawText メソッドの使用方法を示します。 この例を実行するには、コードを Windows フォームに貼り付け、フォームのPaintイベント ハンドラーから を呼び出RenderText6し、 を としてPaintEventArgseします。

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

注釈

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

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

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

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

適用対象

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

例外

dcnullです。

次のコード例は、DrawText メソッドの使用方法を示します。 この例を実行するには、コードを Windows フォームに貼り付け、フォームのPaintイベント ハンドラーから を呼び出RenderText4し、 を としてPaintEventArgseします。

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

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

クラスによって提供される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 値のビットごとの組み合わせ。

例外

dcnullです。

次のコード例は、DrawText メソッドの使用方法を示します。 この例を実行するには、コードを Windows フォームに貼り付け、フォームのPaintイベント ハンドラーから を呼び出RenderText5し、 を としてPaintEventArgseします。

private void RenderText5(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Some text.",
        this.Font, new Point(10, 10), SystemColors.ControlText, TextFormatFlags.Bottom);
}
Private Sub RenderText5(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Some text.", _
    Me.Font, New Point(10, 10), SystemColors.ControlText, _
    TextFormatFlags.Bottom)

End Sub

注釈

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

パラメーターは backColor 、 パラメーター内の領域に bounds 適用されます。 または が または の場合fontDrawTextメソッドは、 で指定されたdcデバイス コンテキストで現在選択されているフォントまたは色でテキストを描画します。Color.EmptynullforecolorTransparentの場合forecolor、テキストは描画されません。

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

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

注意

描画されたテキストの左上隅として を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

例外

dcnullです。

次のコード例は、DrawText メソッドの使用方法を示します。 この例を実行するには、コードを Windows フォームに貼り付け、フォームのPaintイベント ハンドラーから を呼び出RenderText3し、 を としてPaintEventArgseします。

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

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

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

注意

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

適用対象

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 値のビットごとの組み合わせ。

例外

dcnullです。

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

例外

dcnull です。

適用対象

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 値のビットごとの組み合わせ。

例外

dcnullです。

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

例外

dcnull です。

適用対象

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

例外

dcnullです。

次のコード例は、DrawText メソッドの使用方法を示します。 この例を実行するには、コードを Windows フォームに貼り付け、フォームのPaintイベント ハンドラーから を呼び出RenderText2し、 を としてPaintEventArgseします。

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

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

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

こちらもご覧ください

適用対象

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

例外

dcnullです。

次のコード例は、DrawText メソッドの使用方法を示します。 この例を実行するには、コードを Windows フォームに貼り付け、フォームのPaintイベント ハンドラーから を呼び出RenderText1し、 を としてPaintEventArgseします。

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

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

注意

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

こちらもご覧ください

適用対象

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

例外

dcnullです。

適用対象

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 値のビットごとの組み合わせ。

例外

dcnullです。

ModifyString が設定されます。

適用対象