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
新しいコントロールに適用する既定値。 UseCompatibleTextRendering をサポートする新しいコントロールがテキストレンダリングにGDI+ベースGraphicsのクラスを使用する場合trueは、新しいコントロールで falseGDI ベースTextRendererのクラスが使用されます。
例外
このメソッドは、Windows フォーム アプリケーションによって最初のウィンドウが作成される前にしか呼び出すことができません。
例
重要
Visual Basic 2005 以降の既定値UseCompatibleTextRenderingを設定するには、次を参照してくださいWindowsFormsApplicationBase.UseCompatibleTextRendering。
Visual C# 2005 以降では、呼び出し SetCompatibleTextRenderingDefault が Program.cs ファイルに自動的に生成されます。 テキストレンダリングの既定値を変更するには、生成されたコードを変更します。
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 グラフィックス ライブラリに基づくクラスまたはGraphicsGDI+ グラフィックス ライブラリに基づくクラスをTextRenderer使用してテキストをレンダリングできます。 この変更は、GDI+のパフォーマンスとローカリゼーションの問題により、.NET Framework 2.0 で行われました。 それをサポートするコントロールのプロパティのUseCompatibleTextRendering既定値を設定するために使用SetCompatibleTextRenderingDefaultします。
このプロパティはUseCompatibleTextRendering、クラスを使用してテキストをレンダリングするWindows フォーム コントロールと、そのクラスを使用してTextRendererカスタム テキスト レンダリングを実行する .NET Framework 1.0 および .NET Framework 1.1 アプリケーションとの間で視覚的な互換性をGraphics提供することを目的としています。 ほとんどの場合、アプリケーションが .NET Framework 1.0 または .NET Framework 1.1 からアップグレードされていない場合は、既定値falseに設定したままにすることをお勧めしますUseCompatibleTextRendering。
GDI ベースTextRendererのクラスは、.NET Framework 2.0 で、パフォーマンスの向上、テキストの見た目の改善、国際フォントのサポートの向上のために導入されました。 以前のバージョンの.NET Frameworkでは、GDI+ ベースGraphicsのクラスを使用して、すべてのテキストレンダリングが実行されていました。 GDI は、文字間隔と単語の折り返しをGDI+とは異なる方法で計算します。 クラスを使用してテキストをGraphicsレンダリングするWindows フォーム アプリケーションでは、使用するコントロールのテキストがTextRendererアプリケーション内の他のテキストとは異なって表示される可能性があります。 この非互換性を解決するには、プロパティtrueを UseCompatibleTextRendering . アプリケーションでサポートされているすべてのコントロールに対してtrue設定UseCompatibleTextRenderingするには、パラメーターtrueを指定してSetCompatibleTextRenderingDefaultメソッドを呼び出します。
Windows フォーム コードが Internet Explorer などの別のアプリケーションでホストされている場合は、このメソッドを呼び出さないでください。 スタンドアロン Windows フォーム アプリケーションでのみこのメソッドを呼び出します。