GroupBox.UseCompatibleTextRendering Eigenschaft

  • Referenz

Definition

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

Ruft einen Wert ab, der bestimmt, ob die Graphics -Klasse (GDI+) oder die -Klasse (GDI) zum Rendern von Text verwendet werden soll, oder legt diesen TextRenderer fest.

public:
 property bool UseCompatibleTextRendering { bool get(); void set(bool value); };
public bool UseCompatibleTextRendering { get; set; }
member this.UseCompatibleTextRendering : bool with get, set
Public Property UseCompatibleTextRendering As Boolean

Eigenschaftswert

Boolean

true, wenn mit der Graphics-Klasse eine Textdarstellung zur Herstellung von Kompatibilität mit den Versionen 1.0 und 1.1. ausgeführt werden soll. von .NET Framework, andernfalls false. Der Standardwert ist false.

Hinweise

Die UseCompatibleTextRendering -Eigenschaft soll die visuelle Kompatibilität zwischen Windows Forms Steuerelementen bereitstellen, die Text mithilfe der TextRenderer -Klasse rendern, und .NET Framework 1.0- und .NET Framework 1.1-Anwendungen, 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 von falsefestzulegen.

Die GDI-basierte TextRenderer Klasse wurde im .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 der .NET Framework wurde die GDI+-basierte Graphics Klasse verwendet, um das gesamte Textrendering durchzuführen. GDI berechnet den Zeichenabstand und den 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 für ein bestimmtes Steuerelement auf true festlegen. Um für alle unterstützten Steuerelemente in der Anwendung auf festzulegenUseCompatibleTextRendering, rufen Sie die Application.SetCompatibleTextRenderingDefault -Methode mit dem -Parameter auftrue.true

Gilt für:

Weitere Informationen