Bild des TreeView-Kontrollkästchens abgeschnitten

Mit dem TreeNode im TreeView-Steuerelement können Benutzer den DrawMode anpassen und Kontrollkästchen hinzufügen. Das Kontrollkästchenbild wird jedoch aufgrund der Position der TreeNode-Textzeichnung abgeschnitten. Um die normale, übliche Verwendung nicht zu beeinträchtigen, können Sie eine Einstellung für einen AppContext-Schalter verwenden, um das Abschneiden des Kontrollkästchens in diesen bestimmten Situationen zu vermeiden.

Das Bild des Kontrollkästchens wird abgeschnitten, wenn alle folgenden Bedingungen erfüllt sind:

• CheckBoxes ist auf true festgelegt.
• DrawMode ist auf OwnerDrawText festgelegt.
• DrawDefault ist im true-Ereignis auf true festgelegt.

Vorheriges Verhalten

Wenn in früheren Versionen beim TreeView-Steuerelement im CheckBoxes-Ereignis true auf DrawMode, OwnerDrawText auf DrawDefaultund CheckBoxes auf OnDrawNode festgelegt war, wurden die TreeNode-Kontrollkästchenbilder am rechten Rand abgeschnitten dargestellt.

Neues Verhalten

Durch Festlegen des Schalters "System.Windows.Forms.TreeView.MoveTreeViewTextLocationOnePixel": true in der Laufzeitkonfigurationsdatei des Projekts werden die TreeNode-Kontrollkästchen vollständig angezeigt, wenn für TreeView im CheckBoxes-Ereignis true auf DrawMode, OwnerDrawText auf DrawDefault und true auf OnDrawNode festgelegt sind.

Eingeführt in Version

.NET 10

Typ des Breaking Changes

Diese Änderung ist eine Verhaltensänderung.

Grund für Änderung

Durch diese Änderung wird sichergestellt, dass das Kontrollkästchen des Knotens im TreeView-Steuerelement vollständig angezeigt werden kann.

Empfohlene Aktion

Fügen Sie "System.Windows.Forms.TreeView.MoveTreeViewTextLocationOnePixel": true manuell zur runtimeconfig.json Datei des Projekts hinzu, um den Schalter zu aktivieren.

{
    "runtimeOptions": {
        "configProperties": {
            "System.Windows.Forms.TreeView.MoveTreeViewTextLocationOnePixel": true
        }
    }
}

Betroffene APIs

• System.Windows.Forms.TreeView.CheckBoxes