Application.SetCompatibleTextRenderingDefault(Boolean) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define o padrão da aplicação para a UseCompatibleTextRendering propriedade definida em certos controlos.
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);public static void SetCompatibleTextRenderingDefault(bool defaultValue);static member SetCompatibleTextRenderingDefault : bool -> unitPublic Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)Parâmetros
- defaultValue
- Boolean
O valor padrão a usar para novos controlos. Se true, novos controlos que suportam UseCompatibleTextRendering usam a classe baseada Graphics em GDI+ para renderização de texto; se false, novos controlos usam a classe baseada TextRenderer em GDI.
Exceções
Só pode chamar este método antes da primeira janela ser criada pela sua aplicação Windows Forms.
Exemplos
Importante
Para definir o valor padrão para UseCompatibleTextRendering em Visual Basic de 2005 ou posteriores, veja WindowsFormsApplicationBase.UseCompatibleTextRendering.
Para aplicações C#, Visual Studio adiciona automaticamente uma chamada a SetCompatibleTextRenderingDefault no ficheiro Program.cs. Para alterar o padrão de renderização do texto, modifique o código gerado.
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());
}
}
Observações
Certos controlos de Windows Forms podem renderizar o seu texto usando a classe TextRenderer, baseada na biblioteca gráfica GDI, ou a classe Graphics, que se baseia na biblioteca gráfica GDI+. Esta alteração foi feita no .NET Framework 2.0 devido a problemas de desempenho e localização com o GDI+. Use SetCompatibleTextRenderingDefault para definir o valor padrão da UseCompatibleTextRendering propriedade para controlos que suportam essa propriedade.
A propriedade UseCompatibleTextRendering destina-se a proporcionar compatibilidade visual entre Windows Forms controlos que renderizam texto usando a classe TextRenderer e aplicações que realizam renderização personalizada de texto usando a classe Graphics. Na maioria dos casos, recomenda-se que deixe UseCompatibleTextRendering definido com o valor padrão de false.
A classe TextRenderer baseada em GDI foi introduzida no .NET Framework 2.0 para melhorar o desempenho, melhorar o aspeto do texto e melhorar o suporte a fontes internacionais. Nas versões anteriores do .NET Framework, a classe Graphics baseada em GDI+ era usada para realizar toda a renderização de texto. O GDI calcula o espaçamento dos caracteres e o enrolamento de palavras de forma diferente do GDI+. Numa aplicação Windows Forms que usa a classe Graphics para renderizar texto, isto pode fazer com que o texto dos controlos que usam TextRenderer apareça diferente do outro texto na aplicação. Para resolver esta incompatibilidade, pode definir a UseCompatibleTextRendering propriedade para true. Para definir UseCompatibleTextRendering para true todos os controlos suportados na aplicação, chame o SetCompatibleTextRenderingDefault método com um argumento de true.
Nunca deve chamar este método se o seu código do Windows Forms estiver alojado noutra aplicação, como o Internet Explorer. Só chame este método em aplicações Windows Forms autónomas.