Application.SetCompatibleTextRenderingDefault(Boolean) Application.SetCompatibleTextRenderingDefault(Boolean) Application.SetCompatibleTextRenderingDefault(Boolean) Application.SetCompatibleTextRenderingDefault(Boolean) Method

Definición

Establece el valor predeterminado de la aplicación para la propiedad UseCompatibleTextRendering definida en ciertos controles.Sets the application-wide default for the UseCompatibleTextRendering property defined on certain controls.

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 Boolean Boolean Boolean

Valor predeterminado que se va a utilizar con los nuevos controles.The default value to use for new controls. Si es true, los nuevos controles que admiten UseCompatibleTextRendering usan la clase GDI+GDI+ basada en Graphics para la representación de texto; si es false, los nuevos controles usan la clase GDIGDI basada en TextRenderer.If true, new controls that support UseCompatibleTextRendering use the GDI+GDI+ based Graphics class for text rendering; if false, new controls use the GDIGDI based TextRenderer class.

Excepciones

Solo puede llamar a este método antes de crea la primera ventana de la aplicación de Windows Forms.You can only call this method before the first window is created by your Windows Forms application.

Ejemplos

Importante

Para establecer el valor predeterminado de UseCompatibleTextRendering en Visual Basic 2005Visual Basic 2005 o una versión posterior, consulte WindowsFormsApplicationBase.UseCompatibleTextRendering.To set the default value for UseCompatibleTextRendering in Visual Basic 2005Visual Basic 2005 or later, see WindowsFormsApplicationBase.UseCompatibleTextRendering.

En Visual C# 2005Visual C# 2005 o posterior, una llamada a SetCompatibleTextRenderingDefault se genera automáticamente en el archivo Program.cs.In Visual C# 2005Visual C# 2005 or later, a call to SetCompatibleTextRenderingDefault is automatically generated in the Program.cs file. Para cambiar el valor predeterminado de representación de texto, modifique el código generado.To change the text rendering default, modify the generated code.

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

Ciertos controles de Windows Forms pueden representar texto mediante el TextRenderer (clase), que se basa en el GDIGDI biblioteca de gráficos, o la Graphics (clase), que se basa en el GDI+GDI+ biblioteca de gráficos.Certain Windows Forms controls can render their text using either the TextRenderer class, which is based on the GDIGDI graphics library, or the Graphics class, which is based on the GDI+GDI+ graphics library. Este cambio se realizó en el .NET Framework 2.0.NET Framework 2.0 debido a problemas de rendimiento y la localización con GDI+GDI+.This change was made in the .NET Framework 2.0.NET Framework 2.0 because of performance and localization issues with GDI+GDI+. Use SetCompatibleTextRenderingDefault para establecer el valor predeterminado de la UseCompatibleTextRendering propiedad para los controles que lo admiten.Use SetCompatibleTextRenderingDefault to set the default value of the UseCompatibleTextRendering property for controls that support it.

El UseCompatibleTextRendering propiedad está pensada 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.NET Framework 1.0 y .NET Framework 1.1.NET Framework 1.1 las aplicaciones que realizan la representación de texto personalizado mediante la Graphicsclase.The UseCompatibleTextRendering property is intended to provide visual compatibility between Windows Forms controls that render text using the TextRenderer class and .NET Framework 1.0.NET Framework 1.0 and .NET Framework 1.1.NET Framework 1.1 applications that perform custom text rendering using the Graphics class. En la mayoría de los casos, si la aplicación no se está actualizando desde .NET Framework 1.0.NET Framework 1.0 o .NET Framework 1.1.NET Framework 1.1, se recomienda que deje UseCompatibleTextRendering establecido en el valor predeterminado de false.In most cases, if your application is not being upgraded from .NET Framework 1.0.NET Framework 1.0 or .NET Framework 1.1.NET Framework 1.1, it is recommended that you leave UseCompatibleTextRendering set to the default value of false.

El GDIGDI basado TextRenderer clase se introdujo en la .NET Framework 2.0.NET Framework 2.0 para mejorar el rendimiento, convertir texto tenga mejor aspecto y mejorar la compatibilidad con fuentes internacionales.The GDIGDI based TextRenderer class was introduced in the .NET Framework 2.0.NET Framework 2.0 to improve performance, make text look better, and improve support for international fonts. En versiones anteriores de la .NET Framework.NET Framework, el GDI+GDI+ basado Graphics clase se utiliza para realizar la representación de texto de todas.In earlier versions of the .NET Framework.NET Framework, the GDI+GDI+ based Graphics class was used to perform all text rendering. GDIGDI calcula el espaciado entre caracteres y el ajuste de línea de forma diferente de GDI+GDI+.calculates character spacing and word wrapping differently from GDI+GDI+. En una aplicación de Windows Forms que usa el Graphics de clases para representar texto, esto podría provocar que el texto para los controles que usan TextRenderer para tener un aspecto diferente de otros textos de la aplicación.In a Windows Forms application that uses the Graphics class to render text, this could cause the text for controls that use TextRenderer to appear different from the other text in the application. Para resolver esta incompatibilidad, puede establecer el UseCompatibleTextRendering propiedad true.To resolve this incompatibility, you can set the UseCompatibleTextRendering property to 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.To set UseCompatibleTextRendering to true for all supported controls in the application, call the SetCompatibleTextRenderingDefault method with a parameter of true.

Nunca debe llamar a este método si el código de Windows Forms se hospeda en otra aplicación, como Internet Explorer.You should never call this method if your Windows Forms code is hosted in another application, such as Internet Explorer. Solo llame a este método en aplicaciones de Windows Forms independientes.Only call this method in stand-alone Windows Forms applications.

Se aplica a

Consulte también: