Application.SetCompatibleTextRenderingDefault-Methode

Bestimmte Windows Forms-Steuerelemente können den Text mithilfe der TextRenderer-Klasse rendern, die auf der GDI-Grafikbibliothek basiert, oder mithilfe der Graphics-Klasse, die auf der GDI+-Grafikbibliothek basiert. Diese Änderung in .NET Framework 2.0 wurde aufgrund von Leistungs- und Lokalisierungsproblemen in Zusammenhang mit GDI+ vorgenommen. Verwenden Sie SetCompatibleTextRenderingDefault, um den Standardwert der UseCompatibleTextRendering-Eigenschaft für Steuerelemente festzulegen, die sie unterstützen.

Die UseCompatibleTextRendering-Eigenschaft ist dazu gedacht, die visuelle Kompatibilität zwischen Windows Forms-Steuerelementen bereitzustellen, die Text mithilfe der TextRenderer-Klasse und von .NET Framework 1.0- und .NET Framework 1.1-Anwendungen rendern, die benutzerdefiniertes Textrendering mit der Graphics-Klasse ausführen. In den meisten Fällen, wenn die Anwendung nicht von .NET Framework 1.0 oder .NET Framework 1.1 aktualisiert wird, wird empfohlen, dass Sie den Standardwert von false für UseCompatibleTextRendering belassen.

Die auf der GDI basierende TextRenderer-Klasse wurde in .NET Framework 2.0 eingeführt, um die Leistung zu verbessern, die Textdarstellung zu verbessern und die Unterstützung für internationale Schriftarten zu verbessern. In früheren Versionen von .NET Framework wurde die auf GDI+ basierte Graphics-Klasse verwendet, um das gesamte Textrendering auszuführen. GDI berechnet Zeichenabstand und Wortumbruch anders als GDI+. In einer Windows Forms-Anwendung, die die Graphics-Klasse verwendet, um Text zu rendern, kann dies dazu führen, dass der Text für Steuerelemente, die TextRenderer verwenden, in der Anwendung anders als anderer Text erscheint. Um diese Inkompatibilität aufzulösen, können Sie die UseCompatibleTextRendering-Eigenschaft auf true festlegen. Um UseCompatibleTextRendering in der Anwendung auf true für alle unterstützten Steuerelemente festzulegen, rufen Sie die SetCompatibleTextRenderingDefault-Methode mit einem Parameter von true auf.

Diese Methode darf nicht aufgerufen werden, wenn der Windows Forms-Code in einer anderen Anwendung, zum Beispiel in Internet Explorer, gehostet wird. Rufen Sie diese Methode in nur eigenständigen Windows Forms-Anwendungen auf.

Wichtig
Informationen zum Festlegen des Standardwerts für UseCompatibleTextRendering in Visual Basic 2005 oder höher finden Sie unter WindowsFormsApplicationBase.UseCompatibleTextRendering.

In Visual C# 2005 oder höher wird in der Datei Program.cs automatisch ein Aufruf von SetCompatibleTextRenderingDefault generiert. Um den Textrenderingstandard zu ändern, ändern Sie den generierten 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());
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz