Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Application.SetCompatibleTextRenderingDefault (Boolean)

 

Publicado: noviembre de 2016

Establece el valor predeterminado de la aplicación para la propiedad UseCompatibleTextRendering definida en ciertos controles.

Espacio de nombres:   System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public static void SetCompatibleTextRenderingDefault(
	bool defaultValue
)

Parámetros

defaultValue
Type: System.Boolean

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

Exception Condition
InvalidOperationException

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

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

El UseCompatibleTextRendering propiedad está diseñada para proporcionar compatibilidad visual entre los controles de formularios Windows Forms ese texto de presentación mediante el TextRenderer clase y .NET Framework 1.0 y .NET Framework 1.1 aplicaciones que realizan el proceso de representación de texto personalizado utilizando 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 que deje UseCompatibleTextRendering establecida en el valor predeterminado de false.

El GDI según TextRenderer clase se introdujo en la .NET Framework 2.0 para mejorar el rendimiento, que el texto tenga mejor aspecto y mejorar la compatibilidad con fuentes internacionales. En versiones anteriores de la .NET Framework, el GDI+ según Graphics clase se utiliza para realizar toda la representación de texto.GDI calcula el espaciado entre caracteres y ajuste de manera diferente de GDI+. En una aplicación de formularios Windows Forms que usa el Graphics de clases para representar texto, esto podría provocar que el texto de los controles que utilizan TextRenderer aparezca diferente de otros textos de la aplicación. Para resolver esta incompatibilidad, puede establecer el UseCompatibleTextRendering propiedad true. Para establecer UseCompatibleTextRendering a true para todos los controles compatibles en la aplicación, llame a la SetCompatibleTextRenderingDefault método con un parámetro 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. Sólo hay que llamar a este método en aplicaciones de Windows Forms independientes.

System_CAPS_importantImportante

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

En Visual C# 2005 o posterior, una llamada a SetCompatibleTextRenderingDefault se genera automáticamente en el archivo Program.cs. Para cambiar la representación del texto predeterminado, 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());
    }
}

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: