Application.SetCompatibleTextRenderingDefault(Boolean) Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Imposta il valore predefinito a livello di applicazione per la UseCompatibleTextRendering proprietà definita in determinati controlli.

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 utilizzare per i nuovi controlli. Se true, nuovi controlli che supportano l'uso UseCompatibleTextRendering della classe basata su Graphics GDI+ per il rendering del testo; se false, i nuovi controlli usano la classe basata su TextRenderer GDI.

Eccezioni

InvalidOperationException

È possibile chiamare questo metodo solo prima che la prima finestra venga creata dall'applicazione Windows Forms.

Esempio

Importante

Per impostare il valore predefinito per UseCompatibleTextRendering in Visual Basic 2005 o versioni successive, vedere WindowsFormsApplicationBase.UseCompatibleTextRendering.

Per le app C#, Visual Studio aggiunge automaticamente una chiamata a SetCompatibleTextRenderingDefault nel file Program.cs. Per modificare l'impostazione predefinita per il rendering del testo, modificare il codice generato.

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 Windows Forms possono eseguire il rendering del testo usando la classe TextRenderer, basata sulla libreria grafica GDI o sulla classe Graphics, basata sulla libreria grafica GDI+. Questa modifica è stata apportata in .NET Framework 2.0 a causa di problemi di prestazioni e localizzazione con GDI+. Utilizzare SetCompatibleTextRenderingDefault per impostare il valore predefinito della UseCompatibleTextRendering proprietà per i controlli che supportano tale proprietà.

La proprietà consente di garantire la compatibilità visiva tra i controlli Windows Forms che eseguono il rendering del testo usando la classe /> e le app che eseguono il rendering di testo personalizzato usando la classe /> UseCompatibleTextRendering impostato il valore predefinito di false.

La classe TextRenderer basata su GDI è stata introdotta in .NET Framework 2.0 per migliorare le prestazioni, migliorare l'aspetto del testo e migliorare il supporto per i tipi di carattere internazionali. Nelle versioni precedenti di .NET Framework, la classe GDI+ basata su Graphics è stata usata per eseguire tutto il rendering del testo. GDI calcola la spaziatura dei caratteri e la disposizione delle parole in modo diverso da GDI+. In un'applicazione Windows Forms che usa la classe Graphics per il rendering del testo, il testo dei controlli che usano TextRenderer potrebbe essere diverso dall'altro testo nell'applicazione. Per risolvere questa incompatibilità, è possibile impostare la UseCompatibleTextRendering proprietà su true. Per impostare su UseCompatibleTextRenderingtrue per tutti i controlli supportati nell'applicazione, chiamare il SetCompatibleTextRenderingDefault metodo con un argomento di true.

Non chiamare mai questo metodo se il codice Windows Forms è ospitato in un'altra applicazione, ad esempio Internet Explorer. Chiamare questo metodo solo nelle applicazioni Windows Forms autonome.

Si applica a

Vedi anche