Application.SetCompatibleTextRenderingDefault(Boolean) Metodo

  • Riferimento

Definizione

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

Imposta l'impostazione predefinita 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 usare per i nuovi controlli. Se true, nuovi controlli che supportano UseCompatibleTextRendering usano la 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 della creazione della prima finestra da parte dell'applicazione Windows Form.

Esempio

Importante

Per impostare il valore predefinito per UseCompatibleTextRendering in Visual Basic 2005 o versione successiva, 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 TextRenderer classe , basata sulla libreria grafica GDI o sulla Graphics classe , 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 UseCompatibleTextRendering proprietà è progettata per garantire la compatibilità visiva tra i controlli Windows Forms che eseguono il rendering del testo usando la TextRenderer classe e le app che eseguono il rendering del testo personalizzato usando la Graphics classe . Nella maggior parte dei casi, se l'applicazione non viene aggiornata da .NET Framework 1.0 o .NET Framework 1.1, è consigliabile lasciare UseCompatibleTextRendering impostato sul valore predefinito di false.

La classe basata su TextRenderer 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 basata su Graphics GDI+ è 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 Graphics classe per il rendering del testo, il testo per i 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