Application.SetCompatibleTextRenderingDefault(Boolean) メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

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

public:
 static void SetCompatibleTextRenderingDefault(bool defaultValue);
public static void SetCompatibleTextRenderingDefault (bool defaultValue);
static member SetCompatibleTextRenderingDefault : bool -> unit
Public Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)

パラメーター

defaultValue
Boolean

新しいコントロールに適用する既定値。 の場合 true、 をサポート UseCompatibleTextRendering する新しいコントロールは、テキストレンダリングに GDI+ ベース Graphics のクラスを使用します。の場合 false、新しいコントロールは GDI ベース TextRenderer のクラスを使用します。

例外

InvalidOperationException

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

例

重要

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 グラフィックス ライブラリに基づく クラスまたは Graphics GDI+ グラフィックス ライブラリに基づく クラスをTextRenderer使用してテキストをレンダリングできます。 この変更は、GDI+ のパフォーマンスとローカライズの問題により、.NET Framework 2.0 で行われました。 を使用して SetCompatibleTextRenderingDefault 、そのプロパティを UseCompatibleTextRendering サポートするコントロールの プロパティの既定値を設定します。

プロパティはUseCompatibleTextRendering、 クラスを使用してテキストをレンダリングするWindows フォーム コントロールと、 クラスを使用してカスタム テキスト レンダリングをTextRenderer実行するアプリとの間で視覚的な互換性を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するコントロールのテキストが、アプリケーション内の他のテキストとは異なって表示される可能性があります。 この非互換性を解決するには、 プロパティを UseCompatibleTextRendering に true設定します。 アプリケーションでサポートされているすべてのコントロールに 対して を にtrue設定UseCompatibleTextRenderingするには、 の引数trueを指定して SetCompatibleTextRenderingDefault メソッドを呼び出します。

Windows フォーム コードがインターネット エクスプローラーなどの別のアプリケーションでホストされている場合は、このメソッドを呼び出さないでください。 このメソッドは、スタンドアロン Windows フォーム アプリケーションでのみ呼び出します。

適用対象

こちらもご覧ください