Windows Forms Adicionar elemento de configuração

O <add> elemento adiciona uma chave predefinida que especifica se seu aplicativo Windows Form oferece suporte a recursos adicionados a aplicativos do Windows Forms no .NET Framework 4.7 ou posterior.

Sintaxe

<System.Windows.Forms.ApplicationConfigurationSection>
  <add key="key-name" value="key-value" />
</System.Windows.Forms.ApplicationConfigurationSection>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

key nomes de atributos e valores associados

Elementos filho

Nenhum.

Elementos pai

Observações

A partir do .NET Framework 4.7, o <System.Windows.Forms.ApplicationConfigurationSection> elemento permite configurar aplicativos do Windows Forms para aproveitar os recursos adicionados em versões recentes do .NET Framework.

O <System.Windows.Forms.ApplicationConfigurationSection> elemento permite adicionar um ou mais elementos filho <add> , cada um dos quais define uma definição de configuração específica.

Para obter uma visão geral do suporte a DPI alto do Windows Forms, consulte Suporte a DPI alto no Windows Forms.

DpiAwareness

Os aplicativos do Windows Forms que são executados em versões do Windows a partir do Windows 10 Creators Edition e versões de destino do .NET Framework a partir do .NET Framework 4.7 podem ser configurados para aproveitar os aprimoramentos de alto DPI introduzidos no .NET Framework 4.7. Estes são, entre outros:

• 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.

• Melhorias no dimensionamento e layout de vários controles do Windows Forms, como o MonthCalendar controle e o CheckedListBox controle.

Alta consciência de DPI é um recurso de aceitação; por padrão, o valor de DpiAwareness é false. Você pode optar pelo suporte do Windows Forms para reconhecimento de DPI definindo o valor dessa chave como PerMonitorV2 no arquivo de configuração do aplicativo. Se o reconhecimento de DPI estiver habilitado, todos os recursos individuais de DPI também serão habilitados. Estes são, entre outros:

• DPI mensagens alteradas, que são controladas DisableDpiChangedMessageHandling pela chave.

• Suporte a DPI dinâmico, que é controlado pela EnableWindowsFormsHighDpiAutoResizing chave.

• Dimensionamento de controle em uma única passagem, que é controlado pelo Form.DisableSinglePassControlScaling para controles individuais Form , pela AnchorLayout.DisableSinglePassControlScaling chave para controles ancorados e pela MonthCalendar.DisableSinglePassControlScaling chave para o MonthCalendar controle

• Melhorias de layout e dimensionamento de DPI alto, que é controlado pela CheckListBox.DisableHighDpiImprovements chave para o CheckedListBox controle, pela DataGridView.DisableHighDpiImprovements chave para o DataGridView controle e pela Toolstrip.DisableHighDpiImprovements chave para o ToolStrip controle.

A única configuração de aceitação padrão fornecida pela configuração DpiAwareness para PerMonitorV2 geralmente é adequada para novos aplicativos do Windows Forms. No entanto, você pode optar por não receber melhorias individuais de alto DPI adicionando a chave correspondente ao arquivo de configuração do aplicativo. Por exemplo, para aproveitar todos os novos recursos de DPI, exceto o suporte a DPI dinâmico, você adicionaria o seguinte ao arquivo de configuração do aplicativo:

<System.Windows.Forms.ApplicationConfigurationSection>
   <add key="DpiAwareness" value="PerMonitorV2" />
   <!-- Disable dynamic DPI support -->
   <add key="EnableWindowsFormsHighDpiAutoResizing" value="false" />
</System.Windows.Forms.ApplicationConfigurationSection>

Normalmente, você desativa um recurso específico porque optou por manipulá-lo programaticamente.

Para obter mais informações sobre como aproveitar o suporte a DPI alto em aplicativos Windows Forms, consulte Suporte a DPI alto no Windows Forms.

DisableDpiChangedMessageHandling

A partir do .NET Framework 4.7, os controles do Windows Forms geram vários eventos relacionados a alterações no dimensionamento de DPI. Estes incluem o DpiChangedAfterParent, DpiChangedBeforeParente DpiChanged eventos. O valor da DisableDpiChangedMessageHandling chave determina se esses eventos são gerados em um aplicativo do Windows Forms.

Dimensionamento em uma única etapa

O dimensionamento de uma ou várias passagens influencia a perceção da capacidade de resposta da interface do usuário e a aparência visual dos elementos da interface do usuário à medida que são dimensionados. A partir do .NET Framework 4.7, o Windows Forms usa o dimensionamento em uma única passagem. Em versões anteriores do .NET Framework, 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. O dimensionamento em uma única etapa só deve ser desabilitado se seu aplicativo depender do comportamento antigo.

Consulte também

• Seção de configuração do Windows Forms
• Suporte a DPI alto no Windows Forms