TextRendererとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップランキング

TextRenderer クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

テキストの計測および表示に使用するメソッドを提供します。このクラスは継承できません。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 TextRenderer

Visual Basic (使用法)

Dim instance As TextRenderer

public sealed class TextRenderer

C++

public ref class TextRenderer sealed

public final class TextRenderer

JScript

public final class TextRenderer

解説

TextRenderer クラスには、Windows フォームコントロール上のテキストの計測および描画に使用できる一連の static メソッドが用意されています。

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

メモ
TextRenderer の DrawText メソッドでは、印刷はサポートされていません。常に、Graphics クラスの DrawString メソッドを使用するようにしてください。

使用例

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

Visual Basic

Private Sub RenderText1(ByVal
 e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text",
 _
        Me.Font, New Point(10, 10), SystemColors.ControlText)

End Sub

private void RenderText1(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
 
        new Point(10, 10), SystemColors.ControlText);

}

継承階層

System.Object
System.Windows.Forms.TextRenderer

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TextRenderer メンバ
System.Windows.Forms 名前空間

TextRenderer メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	DrawText	オーバーロードされます。指定したテキストを、指定したデバイスコンテキスト、色、およびフォントを使用して、指定した位置に描画します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	MeasureText	オーバーロードされます。指定したフォントを使用して描画した場合の、指定したテキストを計測します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

TextRenderer メンバ

テキストの計測および表示に使用するメソッドを提供します。このクラスは継承できません。

TextRenderer データ型で公開されるメンバを以下の表に示します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	DrawText	オーバーロードされます。指定したテキストを、指定したデバイスコンテキスト、色、およびフォントを使用して、指定した位置に描画します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	MeasureText	オーバーロードされます。指定したフォントを使用して描画した場合の、指定したテキストを計測します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)