LinkLabel.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

Wenn die UseCompatibleTextRendering -Eigenschaft auf falsefestgelegt ist, deckt die LinkArea den gesamten Text ab. Beispielsweise wird Text wie "abcd" mit unterstrichenem nachgestelltem Leerzeichen gerendert.

Wenn die UseCompatibleTextRendering -Eigenschaft auf truefestgelegt ist, deckt nicht LinkArea den gesamten Text ab.

Die UseCompatibleTextRendering -Eigenschaft soll visuelle Kompatibilität zwischen Windows Forms Steuerelementen bieten, die Text mithilfe der TextRenderer -Klasse rendern, und .NET Framework 1.0- und .NET Framework 1.1-Anwendungen, die benutzerdefiniertes Textrendering mithilfe der Graphics -Klasse 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 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 des .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 für ein bestimmtes Steuerelement auf true festlegen. Um auf true für alle unterstützten Steuerelemente in der Anwendung festzulegenUseCompatibleTextRendering, rufen Sie die Application.SetCompatibleTextRenderingDefault -Methode mit dem -Parameter auftrue.

Gilt für:

Weitere Informationen