CheckedListBox.UseCompatibleTextRendering Eigenschaft

Definition

Ruft einen Wert ab, der bestimmt, ob zum Rendern von Text die Graphics-Klasse (GDI+GDI+) oder die TextRenderer-Klasse (GDIGDI) verwendet werden soll, oder legt diesen Wert fest.Gets or sets a value that determines whether to use the Graphics class (GDI+GDI+) or the TextRenderer class (GDIGDI) to render text.

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.true if the Graphics class should be used to perform text rendering for compatibility with versions 1.0 and 1.1. von .NET Framework, andernfalls false.of the .NET Framework; otherwise, false. Der Standardwert ist false.The default is false.

Hinweise

Die UseCompatibleTextRendering -Eigenschaft ist für die visuelle Kompatibilität zwischen Windows Forms Steuerelementen vorgesehen, die Text mithilfe der-Klasse rendern, sowie von TextRenderer .NET Framework 1.0.NET Framework 1.0 .NET Framework 1.1.NET Framework 1.1 Anwendungen, die das benutzerdefinierte Text Rendering mithilfe der- Graphics Klasse ausführen.The UseCompatibleTextRendering property is intended to provide visual compatibility between Windows Forms controls that render text using the TextRenderer class and .NET Framework 1.0.NET Framework 1.0 and .NET Framework 1.1.NET Framework 1.1 applications that perform custom text rendering using the Graphics class. In den meisten Fällen .NET Framework 1.0.NET Framework 1.0 .NET Framework 1.1.NET Framework 1.1 wird empfohlen, UseCompatibleTextRendering auf den Standardwert festzulegen, wenn die Anwendung nicht von oder aktualisiert wird false .In most cases, if your application is not being upgraded from .NET Framework 1.0.NET Framework 1.0 or .NET Framework 1.1.NET Framework 1.1, it is recommended that you leave UseCompatibleTextRendering set to the default value of false.

Die- GDIGDI basierte TextRenderer Klasse wurde in eingeführt .NET Framework 2.0.NET Framework 2.0 , um die Leistung zu verbessern, Text besser aussehen zu lassen und die Unterstützung für Internationale Schriftarten zu verbessern.The GDIGDI based TextRenderer class was introduced in the .NET Framework 2.0.NET Framework 2.0 to improve performance, make text look better, and improve support for international fonts. In früheren Versionen von .NET Framework.NET Framework wurde die- GDI+GDI+ basierte- Graphics Klasse verwendet, um das gesamte Text Rendering auszuführen.In earlier versions of the .NET Framework.NET Framework, the GDI+GDI+ based Graphics class was used to perform all text rendering. GDIGDI berechnet den Zeichenabstand und das Wort Umbruch von GDI+GDI+ .calculates character spacing and word wrapping differently from GDI+GDI+. In einer Windows Forms Anwendung, die die- Graphics Klasse zum Rendering von Text verwendet, kann dies dazu führen, dass der Text für Steuerelemente, die verwenden, TextRenderer von dem anderen Text in der Anwendung abweicht.In a Windows Forms application that uses the Graphics class to render text, this could cause the text for controls that use TextRenderer to appear different from the other text in the application. Um diese Inkompatibilität zu beheben, können Sie die- UseCompatibleTextRendering Eigenschaft true für ein bestimmtes Steuerelement auf festlegen.To resolve this incompatibility, you can set the UseCompatibleTextRendering property to true for a specific control. UseCompatibleTextRendering true Wenn Sie für alle unterstützten Steuerelemente in der Anwendung auf festlegen möchten, müssen Sie die- Application.SetCompatibleTextRenderingDefault Methode mit dem-Parameter aufrufen true .To set UseCompatibleTextRendering to true for all supported controls in the application, call the Application.SetCompatibleTextRenderingDefault method with a parameter of true.

Gilt für:

Weitere Informationen