Label.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.

public:
 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.1true if the Graphics class should be used to perform text rendering for compatibility with versions 1.0 and 1.1. .NET Framework; в противном случае — значение false.of the .NET Framework; otherwise, false. Значение по умолчанию — false.The default is false.

Комментарии

Свойство UseCompatibleTextRendering предназначено для обеспечения визуальной совместимости между элементами управления Windows Forms, которые отображают текст с помощью класса 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.

Класс TextRenderer на основе GDIGDI был представлен в .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 Framework класс Graphics на основе GDI+GDI+ использовался для выполнения всей отрисовки текста.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 Forms приложении, которое использует класс 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.

Применяется к

Дополнительно