Application.SetCompatibleTextRenderingDefault(Boolean) Метод

Определение

Задает значения по умолчанию во всем приложении для свойства UseCompatibleTextRendering, определенного в конкретных элементах управления.Sets the application-wide default for the UseCompatibleTextRendering property defined on certain controls.

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

Значение по умолчанию, используемое для новых элементов управления.The default value to use for new controls. Если задано значение true, новые элементы управления, поддерживающие UseCompatibleTextRendering, используют для отрисовки текста класс Graphics основанный на GDI+GDI+; если задано значение false, новые элементы управления используют класс TextRenderer, основанный на GDIGDI.If true, new controls that support UseCompatibleTextRendering use the GDI+GDI+ based Graphics class for text rendering; if false, new controls use the GDIGDI based TextRenderer class.

Исключения

Этот метод может быть вызван только до того, как первое окно будет создано приложением Windows Forms.You can only call this method before the first window is created by your Windows Forms application.

Примеры

Важно!

Чтобы задать значение по умолчанию для UseCompatibleTextRendering в Visual Basic 2005Visual Basic 2005 или более поздней версии, см. раздел WindowsFormsApplicationBase.UseCompatibleTextRendering.To set the default value for UseCompatibleTextRendering in Visual Basic 2005Visual Basic 2005 or later, see WindowsFormsApplicationBase.UseCompatibleTextRendering.

В Visual C# 2005Visual C# 2005 или более поздней версии вызов SetCompatibleTextRenderingDefault автоматически создается в файле Program.cs.In Visual C# 2005Visual C# 2005 or later, a call to SetCompatibleTextRenderingDefault is automatically generated in the Program.cs file. Чтобы изменить значение по умолчанию для отрисовки текста, измените созданный код.To change the text rendering default, modify the generated code.

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 Forms могут визуализировать свой текст с помощью класса TextRenderer, основанного на библиотеке GDIGDI Graphics, или класса Graphics, который основан на библиотеке GDI+GDI+ Graphics.Certain Windows Forms controls can render their text using either the TextRenderer class, which is based on the GDIGDI graphics library, or the Graphics class, which is based on the GDI+GDI+ graphics library. Это изменение было внесено в .NET Framework 2.0.NET Framework 2.0 из-за проблем с производительностью и локализацией GDI+GDI+.This change was made in the .NET Framework 2.0.NET Framework 2.0 because of performance and localization issues with GDI+GDI+. Используйте SetCompatibleTextRenderingDefault, чтобы задать значение по умолчанию свойства UseCompatibleTextRendering для элементов управления, которые его поддерживают.Use SetCompatibleTextRenderingDefault to set the default value of the UseCompatibleTextRendering property for controls that support it.

Свойство 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. Чтобы присвоить UseCompatibleTextRendering true для всех поддерживаемых элементов управления в приложении, вызовите метод SetCompatibleTextRenderingDefault с параметром true.To set UseCompatibleTextRendering to true for all supported controls in the application, call the SetCompatibleTextRenderingDefault method with a parameter of true.

Этот метод никогда не следует вызывать, если код Windows Forms размещен в другом приложении, например в Internet Explorer.You should never call this method if your Windows Forms code is hosted in another application, such as Internet Explorer. Этот метод следует вызывать только в изолированных Windows Forms приложениях.Only call this method in stand-alone Windows Forms applications.

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

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