Application.SetCompatibleTextRenderingDefault(Boolean) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Define o padrão do aplicativo para a propriedade UseCompatibleTextRendering definida em certos controles.

public:
 static void SetCompatibleTextRenderingDefault(bool defaultValue);
public static void SetCompatibleTextRenderingDefault (bool defaultValue);
static member SetCompatibleTextRenderingDefault : bool -> unit
Public Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)

Parâmetros

defaultValue
Boolean

O valor padrão a ser usado para novos controles. Se true, novos controles compatíveis UseCompatibleTextRendering usam a classe baseada em Graphics GDI+ para renderização de texto; se false, novos controles usam a classe baseada em TextRenderer GDI.

Exceções

InvalidOperationException

Você só pode chamar esse método antes que a primeira janela seja criada pelo seu aplicativo do Windows Forms.

Exemplos

Importante

Para definir o valor padrão para UseCompatibleTextRendering no Visual Basic 2005 ou posterior, consulte WindowsFormsApplicationBase.UseCompatibleTextRendering.

Para aplicativos C#, o Visual Studio adiciona automaticamente uma chamada ao SetCompatibleTextRenderingDefault no arquivo Program.cs . Para alterar o padrão de renderização de 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());
    }
}

Comentários

Determinados controles Windows Forms podem renderizar seu texto usando a TextRenderer classe , que é baseada na biblioteca de elementos gráficos GDI ou na Graphics classe , que é baseada na biblioteca de elementos gráficos GDI+. Essa alteração foi feita no .NET Framework 2.0 devido a problemas de desempenho e localização com GDI+. Use SetCompatibleTextRenderingDefault para definir o valor padrão da UseCompatibleTextRendering propriedade para controles que dão suporte a essa propriedade.

A UseCompatibleTextRendering propriedade destina-se a fornecer compatibilidade visual entre controles Windows Forms que renderizam texto usando a TextRenderer classe e os aplicativos que executam a renderização de texto personalizada usando a Graphics classe . Na maioria dos casos, se o aplicativo não estiver sendo atualizado do .NET Framework 1.0 ou .NET Framework 1.1, é recomendável que você deixe UseCompatibleTextRendering definido como o valor padrão de false.

A classe baseada em TextRenderer GDI foi introduzida no .NET Framework 2.0 para melhorar o desempenho, fazer o texto parecer melhor e melhorar o suporte para fontes internacionais. Em versões anteriores do .NET Framework, a classe baseada em Graphics GDI+ era usada para executar toda a renderização de texto. O GDI calcula o espaçamento de caracteres e o encapsulamento de palavras de forma diferente do GDI+. Em um aplicativo Windows Forms que usa a Graphics classe para renderizar texto, isso pode fazer com que o texto dos controles que usam TextRenderer pareça diferente do outro texto no aplicativo. Para resolve essa incompatibilidade, você pode definir a UseCompatibleTextRendering propriedade como true. Para definir UseCompatibleTextRendering como true para todos os controles com suporte no aplicativo, chame o SetCompatibleTextRenderingDefault método com um argumento de true.

Você nunca deve chamar esse método se o código Windows Forms estiver hospedado em outro aplicativo, como a Internet Explorer. Chame esse método apenas em aplicativos Windows Forms autônomos.

Aplica-se a

Confira também