Application.SetCompatibleTextRenderingDefault(Boolean) Metodo

Definizione

Imposta il valore predefinito per l'intera applicazione relativo alla proprietà UseCompatibleTextRendering definita su determinati controlli.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)

Parametri

defaultValue
Boolean

Valore predefinito da usare per i nuovi controlli.The default value to use for new controls. Se true, i nuovi controlli che supportano UseCompatibleTextRendering usano la classe GDI+GDI+ basata su Graphics per il rendering del testo. Se false, i nuovi controlli usano la classe GDIGDI basata su 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.

Eccezioni

È possibile chiamare questo metodo solo prima della creazione della prima finestra da parte dell'applicazione Windows Form.You can only call this method before the first window is created by your Windows Forms application.

Esempi

Importante

Per impostare il valore predefinito per UseCompatibleTextRendering in Visual Basic 2005Visual Basic 2005 o versioni successive, vedere WindowsFormsApplicationBase.UseCompatibleTextRendering.To set the default value for UseCompatibleTextRendering in Visual Basic 2005Visual Basic 2005 or later, see WindowsFormsApplicationBase.UseCompatibleTextRendering.

In Visual C# 2005Visual C# 2005 o versioni successive, una chiamata a SetCompatibleTextRenderingDefault viene generata automaticamente nel file Program.cs.In Visual C# 2005Visual C# 2005 or later, a call to SetCompatibleTextRenderingDefault is automatically generated in the Program.cs file. Per modificare il valore predefinito per il rendering del testo, modificare il codice generato.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());  
    }  
}  

Commenti

Alcuni controlli di Windows Forms possono eseguire il rendering del testo utilizzando la classe TextRenderer, basata sulla libreria grafica GDIGDI o sulla classe Graphics, basata sulla libreria di grafica GDI+GDI+.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. Questa modifica è stata apportata nel .NET Framework 2.0.NET Framework 2.0 a causa di problemi di prestazioni e localizzazione 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+. Utilizzare SetCompatibleTextRenderingDefault per impostare il valore predefinito della proprietà UseCompatibleTextRendering per i controlli che lo supportano.Use SetCompatibleTextRenderingDefault to set the default value of the UseCompatibleTextRendering property for controls that support it.

La proprietà UseCompatibleTextRendering è progettata per garantire la compatibilità visiva tra i controlli Windows Forms che eseguono il rendering del testo utilizzando la classe TextRenderer e le applicazioni .NET Framework 1.0.NET Framework 1.0 e .NET Framework 1.1.NET Framework 1.1 che eseguono il rendering del testo personalizzato utilizzando la classe Graphics.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. Nella maggior parte dei casi, se l'applicazione non viene aggiornata da .NET Framework 1.0.NET Framework 1.0 o .NET Framework 1.1.NET Framework 1.1, è consigliabile lasciare UseCompatibleTextRendering impostato sul valore predefinito di 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.

La classe TextRenderer basata su GDIGDI è stata introdotta nel .NET Framework 2.0.NET Framework 2.0 per migliorare le prestazioni, rendere il testo migliore e migliorare il supporto per i tipi di carattere internazionali.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. Nelle versioni precedenti del .NET Framework.NET Framework, per eseguire tutto il rendering del testo è stata usata la classe Graphics basata su GDI+GDI+.In earlier versions of the .NET Framework.NET Framework, the GDI+GDI+ based Graphics class was used to perform all text rendering. GDIGDI calcola la spaziatura dei caratteri e il ritorno a capo automatico in modo diverso da GDI+GDI+.calculates character spacing and word wrapping differently from GDI+GDI+. In un Windows Forms Application che usa la classe Graphics per eseguire il rendering del testo, questo potrebbe causare la visualizzazione del testo dei controlli che usano TextRenderer diversi dall'altro testo nell'applicazione.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. Per risolvere l'incompatibilità, è possibile impostare la proprietà UseCompatibleTextRendering su true.To resolve this incompatibility, you can set the UseCompatibleTextRendering property to true. Per impostare UseCompatibleTextRendering su true per tutti i controlli supportati nell'applicazione, chiamare il metodo SetCompatibleTextRenderingDefault con un parametro di true.To set UseCompatibleTextRendering to true for all supported controls in the application, call the SetCompatibleTextRenderingDefault method with a parameter of true.

Questo metodo non deve mai essere chiamato se il codice Windows Forms è ospitato in un'altra applicazione, ad esempio Internet Explorer.You should never call this method if your Windows Forms code is hosted in another application, such as Internet Explorer. Chiamare questo metodo solo nelle applicazioni Windows Forms autonome.Only call this method in stand-alone Windows Forms applications.

Si applica a

Vedi anche