Application.SetCompatibleTextRenderingDefault(Boolean) Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Establece el valor predeterminado para toda la aplicación para la UseCompatibleTextRendering propiedad definida en 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

Valor predeterminado que se va a utilizar con los nuevos controles. Si truees , nuevos controles que admiten UseCompatibleTextRendering el uso de la clase basada en Graphics GDI+ para la representación de texto; si falsees , los nuevos controles usan la clase basada en TextRenderer GDI.

Excepciones

InvalidOperationException

Sólo puede llamar a este método antes de que la aplicación de Windows Forms cree la primera ventana.

Ejemplos

Importante

Para establecer el valor predeterminado de UseCompatibleTextRendering en Visual Basic 2005 o posterior, vea WindowsFormsApplicationBase.UseCompatibleTextRendering.

En el caso de las aplicaciones de C#, Visual Studio agrega automáticamente una llamada a SetCompatibleTextRenderingDefault en el archivo Program.cs . Para cambiar el valor predeterminado de representación de texto, modifique el código generado.

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());  
    }  
}

Comentarios

Algunos controles de Windows Forms pueden representar su texto mediante la TextRenderer clase , que se basa en la biblioteca de gráficos GDI o en la Graphics clase , que se basa en la biblioteca de gráficos de GDI+. Este cambio se realizó en .NET Framework 2.0 debido a problemas de rendimiento y localización con GDI+. Use SetCompatibleTextRenderingDefault para establecer el valor predeterminado de la UseCompatibleTextRendering propiedad para los controles que admiten esa propiedad.

La UseCompatibleTextRendering propiedad está pensada para proporcionar compatibilidad visual entre los controles de Windows Forms que representan texto mediante la TextRenderer clase y las aplicaciones que realizan la representación de texto personalizada mediante la Graphics clase . En la mayoría de los casos, si la aplicación no se está actualizando desde .NET Framework 1.0 o .NET Framework 1.1, se recomienda dejar UseCompatibleTextRendering establecido en el valor predeterminado de false.

La clase basada en TextRenderer GDI se introdujo en .NET Framework 2.0 para mejorar el rendimiento, mejorar el aspecto del texto y mejorar la compatibilidad con fuentes internacionales. En versiones anteriores de .NET Framework, la clase basada en Graphics GDI+ se usaba para realizar toda la representación de texto. GDI calcula el espaciado de caracteres y el ajuste de palabras de forma diferente a GDI+. En una aplicación de Windows Forms que usa la Graphics clase para representar texto, esto podría hacer que el texto de los controles que usan TextRenderer aparezcan diferentes del otro texto de la aplicación. Para resolver esta incompatibilidad, puede establecer la UseCompatibleTextRendering propiedad trueen . Para establecer UseCompatibleTextRenderingtrue en para todos los controles admitidos en la aplicación, llame al SetCompatibleTextRenderingDefault método con un argumento de true.

Nunca debe llamar a este método si el código de Windows Forms se hospeda en otra aplicación, como Internet Explorer. Llame solo a este método en aplicaciones de Windows Forms independientes.

Se aplica a

Consulte también