Application.SetCompatibleTextRenderingDefault(Boolean) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
特定のコントロールで定義されている UseCompatibleTextRendering プロパティのアプリケーション全体の既定値を設定します。
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);public static void SetCompatibleTextRenderingDefault(bool defaultValue);static member SetCompatibleTextRenderingDefault : bool -> unitPublic Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)パラメーター
- defaultValue
- Boolean
新しいコントロールに使用する既定値。
true場合、UseCompatibleTextRenderingをサポートする新しいコントロールは、テキストのレンダリングに GDI+ ベースのGraphics クラスを使用します。false場合、新しいコントロールは GDI ベースのTextRenderer クラスを使用します。
例外
このメソッドは、Windows フォーム アプリケーションによって最初のウィンドウが作成される前にのみ呼び出すことができます。
例
Important
Visual Basic 2005 以降で UseCompatibleTextRendering の既定値を設定するには、WindowsFormsApplicationBase.UseCompatibleTextRendering を参照してください。
C# アプリの場合、Visual Studioは、Program.cs ファイル内の SetCompatibleTextRenderingDefault への呼び出しを自動的に追加します。 テキスト レンダリングの既定値を変更するには、生成されたコードを変更します。
static class Program
{
/// <summary>
/// The main entry point for the application.
/// </summary>
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
}
注釈
特定のWindows フォーム コントロールは、GDI グラフィックス ライブラリに基づく TextRenderer クラス、または GDI+ グラフィックス ライブラリに基づく Graphics クラスを使用してテキストをレンダリングできます。 この変更は、GDI+ のパフォーマンスとローカライズの問題により、.NET Framework 2.0 で行われました。
SetCompatibleTextRenderingDefaultを使用して、そのプロパティをサポートするコントロールのUseCompatibleTextRendering プロパティの既定値を設定します。
UseCompatibleTextRendering プロパティは、TextRenderer クラスを使用してテキストをレンダリングするWindows フォーム コントロールと、Graphics クラスを使用してカスタム テキスト レンダリングを実行するアプリとの間で視覚的な互換性を提供することを目的としています。 ほとんどの場合、 UseCompatibleTextRendering は既定値の false のままにすることをお勧めします。
GDI ベースの TextRenderer クラスは、.NET Framework 2.0 で導入され、パフォーマンスの向上、テキストの見た目の改善、国際フォントのサポートの向上を図ります。 以前のバージョンの .NET Framework では、GDI+ ベースの Graphics クラスを使用して、すべてのテキストレンダリングが実行されていました。 GDI は、GDI+ とは異なる方法で文字間隔とワード ラッピングを計算します。
Graphics クラスを使用してテキストをレンダリングするWindows フォーム アプリケーションでは、TextRenderer を使用するコントロールのテキストが、アプリケーション内の他のテキストとは異なって表示される可能性があります。 この非互換性を解決するには、 UseCompatibleTextRendering プロパティを true に設定します。 アプリケーションでサポートされているすべてのコントロールのtrueにUseCompatibleTextRenderingを設定するには、trueの引数を指定してSetCompatibleTextRenderingDefault メソッドを呼び出します。
Windows フォーム コードが別のアプリケーション (Internet Explorer など) でホストされている場合は、このメソッドを呼び出さないでください。 スタンドアロン Windows フォーム アプリケーションでのみこのメソッドを呼び出します。