Suporte de alto DPI no Windows Forms

Artigo
12/17/2024

A partir do .NET Framework 4.7, o Windows Forms inclui aprimoramentos para cenários comuns de DPI alto e DPI dinâmico. Estes incluem:

Melhorias no dimensionamento e layout de vários controles do Windows Forms, como o controle MonthCalendar e o controle CheckedListBox.
Escalonamento em uma única passagem. No .NET Framework 4.6 e versões anteriores, o dimensionamento era realizado por meio de várias passagens, o que fazia com que alguns controles fossem dimensionados mais do que o necessário.
Suporte para cenários de DPI dinâmico em que o usuário altera o DPI ou o fator de escala após um aplicativo Windows Forms ter sido iniciado.

Em versões do .NET Framework começando com o .NET Framework 4.7, o suporte aprimorado a DPI alto é um recurso de aceitação. Você deve configurar seu aplicativo para aproveitá-lo.

Configurando seu aplicativo Windows Forms para suporte a DPI alto

Os novos recursos do Windows Forms que oferecem suporte a alto reconhecimento de DPI estão disponíveis somente em aplicativos destinados ao .NET Framework 4.7 e em execução em sistemas operacionais Windows a partir da Atualização para Criadores do Windows 10.

Além disso, para configurar o suporte a DPI alto em seu aplicativo Windows Forms, você deve fazer o seguinte:

Declare a compatibilidade com o Windows 10.

Para fazer isso, adicione o seguinte ao seu arquivo de manifesto:

<compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
  <application>
    <!-- Windows 10 compatibility -->
    <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
  </application>
</compatibility>

Habilite o reconhecimento de DPI para cada monitor no arquivo app.config.

O Windows Forms introduz um novo elemento <System.Windows.Forms.ApplicationConfigurationSection> para oferecer suporte a novos recursos e personalizações adicionados a partir do .NET Framework 4.7. Para aproveitar os novos recursos que suportam DPI alto, adicione o seguinte ao arquivo de configuração do aplicativo.
```
<configuration>
  

  <System.Windows.Forms.ApplicationConfigurationSection>
    <add key="DpiAwareness" value="PerMonitorV2" />
  </System.Windows.Forms.ApplicationConfigurationSection>

</configuration>
```
Importante

Em versões anteriores do .NET Framework, você usou o manifesto para adicionar suporte a DPI alto. Essa abordagem não é mais recomendada, pois substitui as configurações definidas no arquivo app.config.

Chame o método estático EnableVisualStyles.

Esta deve ser a primeira chamada de método no ponto de entrada do aplicativo. Por exemplo:

static void Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Application.Run(new Form2());
}

Desativação de recursos individuais de alto DPI

Definir o valor DpiAwareness como PerMonitorV2 habilita todos os recursos de reconhecimento de alto DPI suportados pelas versões do .NET Framework começando com o .NET Framework 4.7. Normalmente, isso é adequado para a maioria dos aplicativos Windows Forms. No entanto, você pode querer desativar um ou mais recursos individuais. A razão mais importante para fazer isso é que o código do aplicativo existente já lida com esse recurso. Por exemplo, se seu aplicativo lida com o dimensionamento automático, convém desabilitar o recurso de redimensionamento automático da seguinte maneira:

<configuration>
  <!-- ... other xml settings ... -->

  <System.Windows.Forms.ApplicationConfigurationSection>
    <add key="DpiAwareness" value="PerMonitorV2" />
    <add key="EnableWindowsFormsHighDpiAutoResizing" value="false" />
  </System.Windows.Forms.ApplicationConfigurationSection>

</configuration>

Para obter uma lista de chaves individuais e seus valores, consultar Windows Forms Add Configuration Element.

Novos eventos de alteração de DPI

A partir do .NET Framework 4.7, três novos eventos permitem que você manipule programaticamente alterações dinâmicas de DPI:

DpiChangedAfterParent, que é ativado quando a configuração de DPI de um controlo é alterada programaticamente após a ocorrência de um evento de alteração de DPI no seu controlo pai ou no formulário.
DpiChangedBeforeParent, que é acionado quando a configuração de DPI para um controle é alterada programaticamente antes que um evento de alteração de DPI para seu controle pai ou formulário tenha ocorrido.
DpiChanged, que é acionado quando a configuração de DPI é alterada no dispositivo de exibição onde o formulário é exibido no momento.

Novos métodos e propriedades auxiliares

O .NET Framework 4.7 também adiciona vários novos métodos auxiliares e propriedades que fornecem informações sobre o dimensionamento de DPI e permitem que você execute o dimensionamento de DPI. Estes incluem:

LogicalToDeviceUnits, que converte um valor de pixel lógico para pixel de dispositivo.
ScaleBitmapLogicalToDevice, que dimensiona uma imagem bitmap para o DPI lógico de um dispositivo.
DeviceDpi, que retorna o DPI do dispositivo atual.

Considerações sobre versões

Além de ser executado no .NET Framework 4.7 e no Windows 10 Creators Update, seu aplicativo também pode ser executado em um ambiente no qual não é compatível com melhorias de alto DPI. Nesse caso, você precisará desenvolver um fallback para seu aplicativo. Você pode fazer isso para executar o desenho personalizado para gerir o escalonamento.

Para fazer isso, você também precisa determinar o sistema operacional no qual seu aplicativo está sendo executado. Você pode fazer isso com um código como o seguinte:

// Create a reference to the OS version of Windows 10 Creators Update.
Version OsMinVersion = new Version(10, 0, 15063, 0);

// Access the platform/version of the current OS.
Console.WriteLine(Environment.OSVersion.Platform.ToString());
Console.WriteLine(Environment.OSVersion.VersionString);

// Compare the current version to the minimum required version.
Console.WriteLine(Environment.OSVersion.Version.CompareTo(OsMinVersion));

Observe que seu aplicativo não detetará com êxito o Windows 10 se ele não estiver listado como um sistema operacional suportado no manifesto do aplicativo.

Você também pode verificar a versão do .NET Framework que o aplicativo foi criado para:

Console.WriteLine(AppDomain.CurrentDomain.SetupInformation.TargetFrameworkName);

Partilhar via