Application.SetCompatibleTextRenderingDefault メソッド

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

Application.SetCompatibleTextRenderingDefault メソッド

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

特定のコントロールで定義された UseCompatibleTextRendering プロパティにアプリケーション全体で有効な既定値を設定します。

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

Visual Basic (宣言)

Public Shared Sub SetCompatibleTextRenderingDefault
 ( _
    defaultValue As Boolean _
)

Visual Basic (使用法)

Dim defaultValue As Boolean

Application.SetCompatibleTextRenderingDefault(defaultValue)

C#

public static void SetCompatibleTextRenderingDefault
 (
    bool defaultValue
)

C++

public:
static void SetCompatibleTextRenderingDefault
 (
    bool defaultValue
)

J#

public static void SetCompatibleTextRenderingDefault
 (
    boolean defaultValue
)

JScript

public static function SetCompatibleTextRenderingDefault
 (
    defaultValue : boolean
)

パラメータ

defaultValue

新しいコントロールに適用する既定値。true の場合、UseCompatibleTextRendering をサポートする新しいコントロールは、テキスト表示用の GDI+ を使用し、false の場合は、GDI+ を使用します。

例外

例外の種類	条件
InvalidOperationException	このメソッドは、Windows フォーム アプリケーションによって最初のウィンドウが作成される前にしか呼び出すことができません。

解説

特定の Windows フォーム コントロールでは、GDI グラフィックス ライブラリまたはより新しい GDI+ ライブラリのいずれを使用してもテキストを描画できます。このように変更されたのは、GDI+ にパフォーマンスとローカライズに関する問題があるからです。既定では、UseCompatibleTextRendering プロパティをサポートする既存のコントロールは、下位互換性を確保するために true に設定されますが、Visual Studio などの環境のすべての新しいコントロールでは、このプロパティは一様に false に設定されます。新しいコントロールの既定のテキスト描画方法を切り替える場合は、SetCompatibleTextRenderingDefault を使用します。

Windows フォームのコードが、Internet Explorer などの別のアプリケーションでホストされる場合、このメソッドは呼び出さないでください。このメソッドを呼び出すのは、スタンドアロンの Windows フォーム アプリケーションに限定してください。

プラットフォーム

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

参照

関連項目
Application クラス
Application メンバ
System.Windows.Forms 名前空間