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 класс на основе Graphics GDI+ для отрисовки текста; если false— , новые элементы управления используют класс на основе TextRenderer GDI.

Исключения

InvalidOperationException

Этот метод может быть вызван только до того, как первое окно будет создано приложением Windows Forms.

Примеры

Важно!

Чтобы задать значение по умолчанию для UseCompatibleTextRendering в Visual Basic 2005 или более поздней версии, см. раздел 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 Forms могут отображать текст с помощью TextRenderer класса , основанного на библиотеке графики GDI, или Graphics класса , основанного на графической библиотеке GDI+. Это изменение было внесено в платформа .NET Framework 2.0 из-за проблем с производительностью и локализацией в GDI+. Используйте , SetCompatibleTextRenderingDefault чтобы задать значение UseCompatibleTextRendering по умолчанию свойства для элементов управления, которые его поддерживают.

Свойство UseCompatibleTextRendering предназначено для обеспечения визуальной совместимости между Windows Forms элементами управления, которые отрисовывает текст с помощью TextRenderer класса , и приложениями платформа .NET Framework 1.0 и платформа .NET Framework 1.1, которые выполняют настраиваемую отрисовку текста с помощью Graphics класса . В большинстве случаев, если приложение не обновляется с платформа .NET Framework 1.0 или платформа .NET Framework 1.1, рекомендуется оставить UseCompatibleTextRendering значение по умолчанию false.

Класс на основе TextRenderer GDI был представлен в платформа .NET Framework 2.0 для повышения производительности, улучшения внешнего вида текста и улучшения поддержки международных шрифтов. В более ранних версиях платформа .NET Framework для отрисовки текста использовался класс на основе Graphics GDI+. GDI вычисляет интервалы между символами и обтекание словами по-разному, чем GDI+. В приложении Windows Forms, которое использует Graphics класс для отрисовки текста, это может привести к тому, что текст для элементов управления, которые используютTextRenderer, будет отличаться от другого текста в приложении. Чтобы устранить эту несовместимость, можно присвоить свойству UseCompatibleTextRendering значение true. Чтобы присвоить значение UseCompatibleTextRenderingtrue для всех поддерживаемых элементов управления в приложении, вызовите SetCompatibleTextRenderingDefault метод с параметром true.

Никогда не следует вызывать этот метод, если код Windows Forms размещен в другом приложении, например Internet Explorer. Вызывайте этот метод только в автономных приложениях Windows Forms.

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

См. также раздел