Application.SetCompatibleTextRenderingDefault(Boolean) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Legt für die gesamte Anwendung die Voreinstellung für die UseCompatibleTextRendering-Eigenschaft fest, die in bestimmten Steuerelementen definiert ist.

public:
 static void SetCompatibleTextRenderingDefault(bool defaultValue);
public static void SetCompatibleTextRenderingDefault (bool defaultValue);
static member SetCompatibleTextRenderingDefault : bool -> unit
Public Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)

Parameter

defaultValue
Boolean

Der Standardwert, der für neue Steuerelemente verwendet werden soll. Wenn true, neue Steuerelemente, die UseCompatibleTextRendering unterstützen, verwenden die GDI+ basierte Klasse für das Textrendering. Wenn falseneue Steuerelemente die GDI-basierte Graphics TextRenderer Klasse verwenden.

Ausnahmen

InvalidOperationException

Sie können diese Methode nur aufrufen, bevor das erste Fenster von der Windows Forms-Anwendung erstellt wurde.

Beispiele

Wichtig

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

In Visual C# 2005 oder höher wird ein Aufruf SetCompatibleTextRenderingDefault automatisch in der Datei "Program.cs" generiert. Ändern Sie den generierten Code, um den Textrenderingstandard zu ändern.

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());  
    }  
}

Hinweise

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

Die UseCompatibleTextRendering Eigenschaft soll die visuelle Kompatibilität zwischen Windows Forms Steuerelementen bereitstellen, die Text mithilfe der TextRenderer Klasse und .NET Framework 1.0- und .NET Framework 1.1-Anwendungen rendern, die mithilfe der Graphics Klasse benutzerdefiniertes Textrendering ausführen. Wenn Ihre Anwendung in den meisten Fällen nicht von .NET Framework 1.0 oder .NET Framework 1.1 aktualisiert wird, empfiehlt es sich, den UseCompatibleTextRendering Standardwert festzulegenfalse.

Die GDI-basierte TextRenderer Klasse wurde in der .NET Framework 2.0 eingeführt, um die Leistung zu verbessern, Text besser aussehen zu lassen und die Unterstützung für internationale Schriftarten zu verbessern. In früheren Versionen des .NET Framework wurde die GDI+ basierte Graphics Klasse verwendet, um alle Textrendering auszuführen. GDI berechnet zeichenabstand und Wortumbruch anders als GDI+. In einer Windows Forms Anwendung, die die Graphics Klasse zum Rendern von Text verwendet, kann dies dazu führen, dass der Text für Steuerelemente, die verwendet werden, TextRenderer anders als der andere Text in der Anwendung angezeigt wird. Um diese Inkompatibilität zu beheben, können Sie die UseCompatibleTextRendering Eigenschaft auf truefestlegen. Um für alle unterstützten Steuerelemente in der Anwendung festzulegen UseCompatibleTextRendering true , rufen Sie die SetCompatibleTextRenderingDefault Methode mit einem Parameter von true.

Sie sollten diese Methode nie aufrufen, wenn Ihr Windows Forms Code in einer anderen Anwendung gehostet wird, z. B. Internet Explorer. Rufen Sie diese Methode nur in eigenständigen Windows Forms Anwendungen auf.

Gilt für:

Siehe auch