Escalado automático

El escalado automático permite que un formulario y sus controles, diseñados en una máquina con una determinada resolución de pantalla o fuente, se muestren adecuadamente en otra máquina con una resolución de pantalla o fuente diferente. Los formularios y los controles cambian de tamaño inteligentemente para mantener la coherencia con las ventanas nativas y otras aplicaciones en las máquinas de los usuarios y otros desarrolladores. El escalado automático y los estilos visuales ayudan a las aplicaciones de Windows Forms a mantener un aspecto coherente en comparación con las aplicaciones nativas de Windows en el equipo de cada usuario.

En su mayor parte, el escalado automático funciona según lo previsto en Windows Forms. Sin embargo, los cambios en la combinación de fuentes pueden ser problemáticos. Para ver un ejemplo de cómo resolver este problema, consulte Cómo: Responder a los cambios del esquema de fuentes en una aplicación de Windows Forms.

Reconocimiento de PPP en .NET

El reconocimiento de PPP se configura a través del archivo de proyecto mediante la ApplicationHighDpiMode propiedad , que se establece SystemAware en de forma predeterminada. Esta configuración trabaja junto con el sistema de inicio de la aplicación para configurar automáticamente la gestión de DPI al iniciarse la aplicación.

El modo de DPI predeterminado y recomendado en las aplicaciones de Windows Forms es SystemAware. Este modo consulta la configuración de PPP una vez al inicio de la aplicación y usa ese valor durante toda la duración de la aplicación, lo que proporciona un comportamiento de escalado coherente.

Configure el modo DPI en su archivo de proyecto:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <ApplicationHighDpiMode>SystemAware</ApplicationHighDpiMode>
  </PropertyGroup>
</Project>

Note

Aunque el enfoque recomendado es configurar los PPP a través del archivo del proyecto, aún es posible usar un archivo de manifiesto de la aplicación (app.manifest) para anular estos ajustes. Sin embargo, no se recomienda usar el manifiesto porque puede provocar conflictos con la configuración de la aplicación. Para obtener más información, vea WFO0003 advertencia del compilador.

consideraciones del diseñador de Visual Studio

Al diseñar formularios en Visual Studio, es posible que tenga que configurar el reconocimiento de PPP del diseñador por separado de la aplicación. A partir de la versión 17.8 de Visual Studio 2022, puede establecer la propiedad ForceDesignerDPIUnaware en el archivo del proyecto para que el diseñador de Windows Forms se ejecute en modo sin reconocimiento de PPP. Esta configuración ayuda a evitar problemas de visualización al diseñar formularios en monitores de alta densidad de píxeles (PPP):

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <ForceDesignerDPIUnaware>true</ForceDesignerDPIUnaware>
  </PropertyGroup>
</Project>

Esta propiedad solo afecta al diseñador de Visual Studio y no cambia cómo se ejecuta la aplicación. Para obtener más información, consulte Deshabilitar la compatibilidad con PPP para corregir problemas de escalado.

Los modos de DPI disponibles incluyen:

SystemAware—La aplicación consulta el valor de DPI una sola vez al iniciarse y utiliza este valor durante toda la ejecución de la aplicación.
PerMonitor—La aplicación comprueba los cambios de DPI en cada monitor y reajusta la escala cuando el DPI cambia.
PerMonitorV2: similar a PerMonitor, pero habilita las notificaciones de cambio de PPP de ventana secundaria y mejora el comportamiento de escalado.
DpiUnaware—La aplicación no se adapta a los cambios de DPI, y Windows se encarga del escalado.
DpiUnawareGdiScaled: similar a DpiUnaware pero proporciona una mejor calidad para el contenido basado en GDI.

Para obtener más información sobre cómo configurar los valores de PPP, vea Novedades de Windows Forms para .NET 6.

Necesidad de escalado automático

Sin escalado automático, una aplicación diseñada para una resolución de pantalla o fuente parece demasiado pequeña o demasiado grande cuando esa resolución o fuente cambia. Por ejemplo, si diseña una aplicación con Tahoma 9 punto como línea base, sin ajustarlo parece demasiado pequeño cuando se ejecuta en una máquina donde la fuente del sistema es Tahoma 12 punto. Los elementos de texto, como los títulos, los menús y el contenido de los cuadros de texto, se muestran más pequeños que en otras aplicaciones. Además, el tamaño de los elementos de la interfaz de usuario (UI) que contienen texto, como la barra de título, los menús y muchos controles, dependen de la fuente usada. En este ejemplo, estos elementos también aparecen relativamente más pequeños.

Una situación análoga se produce cuando se diseña una aplicación para una determinada resolución de pantalla. La resolución de pantalla más común es de 96 puntos por pulgada (PPP), lo que equivale a una escala de pantalla del 100 %, pero las pantallas de mayor resolución, que admiten un 125 %, 150 %, 200 % (que equivalen, respectivamente, a 120, 144 y 192 PPP) o más, son cada vez más comunes. Sin ajuste, una aplicación, especialmente una basada en gráficos, diseñada para una resolución aparece demasiado grande o demasiado pequeña cuando se ejecuta en otra resolución.

El escalado automático soluciona estos problemas al cambiar automáticamente el tamaño del formulario y sus controles secundarios según el tamaño de fuente relativo o la resolución de pantalla. El sistema operativo Windows admite el escalado automático de cuadros de diálogo mediante una unidad de medida relativa denominada unidades de diálogo. Una unidad de diálogo se basa en la fuente del sistema y su relación con píxeles se puede determinar a través de la función GetDialogBaseUnitsdel SDK de Win32 . Cuando un usuario cambia el tema usado por Windows, todos los cuadros de diálogo se ajustan automáticamente en consecuencia. Windows Forms admite el escalado automático según la fuente predeterminada del sistema o la resolución de pantalla. Opcionalmente, puede deshabilitar el escalado automático en una aplicación.

Precaución

No se admiten combinaciones arbitrarias de PPP y modos de escalado de la fuente. Aunque puede escalar un control de usuario con un modo (por ejemplo, DPI) y colocarlo en un formulario con otro modo (Fuente) sin problemas, mezclar un formulario base en un modo y un formulario derivado en otro puede provocar resultados inesperados.