Application.SetCompatibleTextRenderingDefault(Boolean) Methode
Definition
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 eigenschaft fest, die UseCompatibleTextRendering für bestimmte Steuerelemente definiert ist.
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);public static void SetCompatibleTextRenderingDefault(bool defaultValue);static member SetCompatibleTextRenderingDefault : bool -> unitPublic 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
Sie können diese Methode nur aufrufen, bevor das erste Fenster von Ihrer Windows Forms Anwendung erstellt wird.
Beispiele
Important
Informationen zum Festlegen des Standardwerts für UseCompatibleTextRendering in Visual Basic 2005 oder höher finden Sie unter WindowsFormsApplicationBase.UseCompatibleTextRendering.
Bei C#-Apps fügt Visual Studio automatisch einen Aufruf von SetCompatibleTextRenderingDefault in der Datei Program.cs hinzu. Ä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 entweder mithilfe der klasse TextRenderer 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. Hiermit legen Sie SetCompatibleTextRenderingDefault den Standardwert der UseCompatibleTextRendering Eigenschaft für Steuerelemente fest, die diese Eigenschaft unterstützen.
Die UseCompatibleTextRendering-Eigenschaft soll die visuelle Kompatibilität zwischen Windows Forms Steuerelementen ermöglichen, die Text mithilfe der klasse TextRenderer und Apps rendern, die benutzerdefiniertes Textrendering mithilfe der Graphics-Klasse ausführen. In den meisten Fällen wird empfohlen, den UseCompatibleTextRendering Standardwert von false.
Die GDI-basierte TextRenderer-Klasse wurde in .NET Framework 2.0 eingeführt, um die Leistung zu verbessern, das Aussehen von Text zu verbessern und die Unterstützung für internationale Schriftarten zu verbessern. In früheren Versionen von .NET Framework wurde die GDI+-basierte Graphics-Klasse zum Ausführen des gesamten Textrenderings verwendet. GDI berechnet den Zeichenabstand und den Umbruch von Wörtern anders als GDI+. In einer Windows Forms Anwendung, die die klasse Graphics zum Rendern von Text verwendet, kann dies dazu führen, dass der Text für Steuerelemente, die TextRenderer verwenden, anders als der andere Text in der Anwendung angezeigt wird. Um diese Inkompatibilität zu beheben, können Sie die UseCompatibleTextRendering Eigenschaft auf true. Rufen Sie die SetCompatibleTextRenderingDefault Methode mit einem Argument trueauf, um für true alle unterstützten Steuerelemente in der Anwendung festzulegenUseCompatibleTextRendering.
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.