Application.SetCompatibleTextRenderingDefault(Boolean) Método

Definição

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

Define o padrão de todo o aplicativo para a UseCompatibleTextRendering propriedade definida em determinados 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 aplicativo Windows Forms.

Exemplos

Importante

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

Para aplicativos C#, Visual Studio adiciona automaticamente uma chamada a 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 classe TextRenderer, que se baseia na biblioteca de elementos gráficos GDI ou na classe Graphics, 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 o GDI+. Use SetCompatibleTextRenderingDefault para definir o valor padrão da UseCompatibleTextRendering propriedade para controles que dão suporte a essa propriedade.

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

A classe TextRenderer baseada em 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 Graphics baseada em GDI+ foi 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 classe Graphics para renderizar texto, isso pode fazer com que o texto para controles que usam TextRenderer pareça diferente do outro texto no aplicativo. Para resolver essa incompatibilidade, você pode definir a UseCompatibleTextRendering propriedade como true. Para definir UseCompatibleTextRendering para true 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 Internet Explorer. Chame esse método apenas em aplicativos Windows Forms autônomos.

Aplica-se a

Confira também