Application.SetCompatibleTextRenderingDefault(Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает значение по умолчанию для свойства, определенного UseCompatibleTextRendering для определенных элементов управления.
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);public static void SetCompatibleTextRenderingDefault(bool defaultValue);static member SetCompatibleTextRenderingDefault : bool -> unitPublic Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)Параметры
- defaultValue
- Boolean
Значение по умолчанию, используемое для новых элементов управления. Если trueновые элементы управления, поддерживающие UseCompatibleTextRendering класс GDI+ для отрисовки текста; если falseновые элементы управления используют класс на основе TextRendererGraphics GDI.
Исключения
Этот метод можно вызвать только перед созданием первого окна приложением Windows Forms.
Примеры
Important
Чтобы задать значение по умолчанию для UseCompatibleTextRendering в Visual Basic 2005 или более поздней версии, см. раздел WindowsFormsApplicationBase.UseCompatibleTextRendering.
Для приложений C# Visual Studio автоматически добавляет вызов 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 />, выполняющих отрисовку пользовательского текста с помощью класса Graphics. В большинстве случаев рекомендуется оставить UseCompatibleTextRendering значение по умолчанию false.
Класс TextRenderer на основе GDI был представлен в .NET Framework 2.0 для повышения производительности, улучшения внешнего вида текста и улучшения поддержки международных шрифтов. В более ранних версиях .NET Framework класс GDI+ на основе Graphics использовался для выполнения всей отрисовки текста. GDI вычисляет интервалы символов и оболочку слов по-разному от GDI+. В приложении Windows Forms, использующего класс Graphics для отрисовки текста, это может привести к тому, что текст элементов управления, использующих TextRenderer, отличается от другого текста в приложении. Чтобы устранить эту несовместимость, можно задать UseCompatibleTextRendering для свойства значение true. Чтобы задать UseCompatibleTextRenderingtrue значение для всех поддерживаемых элементов управления в приложении, вызовите SetCompatibleTextRenderingDefault метод с аргументом true.
Этот метод никогда не следует вызывать, если код Windows Forms размещен в другом приложении, например Internet Explorer. Вызовите этот метод только в автономных Windows Forms приложениях.