CheckedListBox.UseCompatibleTextRendering プロパティ


テキストのレンダリングに Graphics クラス (GDI+GDI+) を使用するか、TextRenderer クラス (GDIGDI) を使用するかを決定する値を取得または設定します。Gets or sets a value that determines whether to use the Graphics class (GDI+GDI+) or the TextRenderer class (GDIGDI) to render text.

 property bool UseCompatibleTextRendering { bool get(); void set(bool value); };
public bool UseCompatibleTextRendering { get; set; }
member this.UseCompatibleTextRendering : bool with get, set
Public Property UseCompatibleTextRendering As Boolean



true クラスを使用して、 Graphics バージョン1.0 および1.1 との互換性を保つためにテキストレンダリングを実行する場合は。true if the Graphics class should be used to perform text rendering for compatibility with versions 1.0 and 1.1. .NET Framework の。それ以外の場合は falseof the .NET Framework; otherwise, false. 既定値は、false です。The default is false.


UseCompatibleTextRenderingプロパティは、クラスを使用してテキストを表示する Windows フォームコントロールと、 TextRenderer .NET Framework 1.0.NET Framework 1.0 .NET Framework 1.1.NET Framework 1.1 クラスを使用してカスタムテキストレンダリングを実行するアプリケーションの間で、視覚的な互換性を提供することを目的としてい Graphics ます。The UseCompatibleTextRendering property is intended to provide visual compatibility between Windows Forms controls that render text using the TextRenderer class and .NET Framework 1.0.NET Framework 1.0 and .NET Framework 1.1.NET Framework 1.1 applications that perform custom text rendering using the Graphics class. ほとんどの場合、アプリケーションがまたはからアップグレードされていない場合は、 .NET Framework 1.0.NET Framework 1.0 .NET Framework 1.1.NET Framework 1.1 UseCompatibleTextRendering を既定値のに設定したままにしておくことをお勧め false します。In most cases, if your application is not being upgraded from .NET Framework 1.0.NET Framework 1.0 or .NET Framework 1.1.NET Framework 1.1, it is recommended that you leave UseCompatibleTextRendering set to the default value of false.

GDIGDIベースの TextRenderer クラスは、 .NET Framework 2.0.NET Framework 2.0 パフォーマンスを向上させるために、テキストの外観を改善し、国際対応フォントのサポートを強化するためにで導入されました。The GDIGDI based TextRenderer class was introduced in the .NET Framework 2.0.NET Framework 2.0 to improve performance, make text look better, and improve support for international fonts. 以前のバージョンのでは .NET Framework.NET FrameworkGDI+GDI+ ベースのクラスを使用してすべての Graphics テキスト表示を実行していました。In earlier versions of the .NET Framework.NET Framework, the GDI+GDI+ based Graphics class was used to perform all text rendering. GDIGDI とは異なり、文字間隔と単語の折り返しを計算し GDI+GDI+ ます。calculates character spacing and word wrapping differently from GDI+GDI+. クラスを使用してテキストを表示する Windows フォームアプリケーションでは、 Graphics を使用するコントロールのテキストが、 TextRenderer アプリケーション内の他のテキストとは異なるものとして表示されることがあります。In a Windows Forms application that uses the Graphics class to render text, this could cause the text for controls that use TextRenderer to appear different from the other text in the application. この非互換性を解決するには、 UseCompatibleTextRendering 特定の true コントロールに対してプロパティをに設定します。To resolve this incompatibility, you can set the UseCompatibleTextRendering property to true for a specific control. UseCompatibleTextRendering true アプリケーションでサポートされているすべてのコントロールに対してをに設定するには、 Application.SetCompatibleTextRenderingDefault のパラメーターを指定してメソッドを呼び出し true ます。To set UseCompatibleTextRendering to true for all supported controls in the application, call the Application.SetCompatibleTextRenderingDefault method with a parameter of true.