Truncamiento de la imagen de la casilla de verificación de TreeView

Artículo
02/05/2025

El TreeNode del control TreeView permite a los usuarios personalizar DrawMode y agregar casillas. Sin embargo, la imagen de la casilla de verificación se truncará debido a la posición del dibujo de texto de TreeNode. Para evitar que afecte al uso normal, puede utilizar una configuración de modificador AppContext para evitar el truncamiento de las casillas de verificación en estas situaciones específicas.

La imagen de casilla se trunca cuando se cumplen todas las condiciones siguientes:

CheckBoxes se establece en true.
DrawMode se establece en OwnerDrawText.
DrawDefault se establece en true durante el evento OnDrawNode

Comportamiento anterior

En versiones anteriores, cuando el control TreeView tenía CheckBoxes establecido en true, DrawMode establecido en OwnerDrawTexty DrawDefault establecido en true en el evento "OnDrawNode", las imágenes de las casillas de verificación de TreeNode se mostraron truncadas en el borde derecho.

Nuevo comportamiento

Al establecer el modificador "System.Windows.Forms.TreeView.MoveTreeViewTextLocationOnePixel": true en el archivo de configuración en tiempo de ejecución del proyecto, las casillas de verificación de TreeNode se muestran completamente cuando TreeView tiene CheckBoxes establecido en true, DrawMode establecido en OwnerDrawText y DrawDefault establecido en true durante el evento OnDrawNode.

Versión introducida

.NET 10 Preview 1

Tipo de cambio importante

Este cambio es un cambio de comportamiento .

Motivo del cambio

Este cambio garantiza que la casilla de verificación del nodo en el control TreeView se pueda mostrar completamente.

Acción recomendada

Agregue manualmente "System.Windows.Forms.TreeView.MoveTreeViewTextLocationOnePixel": true al archivo runtimeconfig.json del proyecto para habilitar el interruptor.

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

APIs afectadas

System.Windows.Forms.TreeView.CheckBoxes

Compartir vía