Application.SetCompatibleTextRenderingDefault(Boolean) Metodo
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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)
- 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.
È possibile chiamare questo metodo solo prima della creazione della prima finestra da parte dell'applicazione Windows Form.
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());
}
}
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 UseCompatibleTextRendering
true
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.
Prodotto | Versioni |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: