Application.SetCompatibleTextRenderingDefault(Boolean) Método

Definición

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

Establece el valor predeterminado de 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 usar para 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

Solo 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.

Para 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 clase TextRenderer, que se basa en la biblioteca de gráficos GDI o en la Graphics clase, que se basa en la biblioteca de gráficos 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 propiedad /> . En la mayoría de los casos, se recomienda dejar UseCompatibleTextRendering establecido en el valor predeterminado de false.

La clase TextRenderer basada en GDI se introdujo en .NET Framework 2.0 para mejorar el rendimiento, mejorar el aspecto del texto y mejorar la compatibilidad con las fuentes internacionales. En versiones anteriores de .NET Framework, la clase Graphics basada en GDI+ se usó para realizar toda la representación de texto. GDI calcula el espaciado de caracteres y el ajuste de palabras de forma diferente de GDI+. En una aplicación de Windows Forms que usa la clase /> aparezcan diferentes del otro texto de la aplicación. Para resolver esta incompatibilidad, puede establecer la UseCompatibleTextRendering propiedad trueen . Para establecer en trueUseCompatibleTextRendering 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