Application.SetCompatibleTextRenderingDefault(Boolean) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Legt den anwendungsweiten Standardwert für die UseCompatibleTextRendering für bestimmte Steuerelemente definierte Eigenschaft fest.

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. Wenntrue, verwenden neue Steuerelemente, die die GDI+-basierte Graphics Klasse für das Textrendering unterstützenUseCompatibleTextRendering. Wennfalse, verwenden neue Steuerelemente die GDI-basierte TextRenderer Klasse.

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 in Visual Basic 2005 oder höher finden Sie unter WindowsFormsApplicationBase.UseCompatibleTextRendering.

Für C#-Apps fügt Visual Studio automatisch einen Aufruf von SetCompatibleTextRenderingDefault in der Datei Program.cs hinzu. 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());
    }
}

Hinweise

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

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

Die GDI-basierte TextRenderer Klasse wurde in .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 von .NET Framework wurde die GDI+-basierte Graphics Klasse verwendet, um das gesamte Textrendering durchzufü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 werdenTextRenderer, 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 auf true für alle unterstützten Steuerelemente in der Anwendung festzulegenUseCompatibleTextRendering, rufen Sie die SetCompatibleTextRenderingDefault -Methode mit dem Argument auf trueauf.

Sie sollten diese Methode niemals 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:

Freigeben über