Partilhar via

Windows Forms Adicionar elemento de configuração

  • Artigo

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

Atributo Description
key Atributo obrigatório. Um nome de chave predefinido que corresponde a um recurso personalizável específico do Windows Forms.
value Atributo obrigatório. O valor a ser atribuído a key.

key nomes de atributos e valores associados

key Designação Valores Description
"AnchorLayout.DisableSinglePassControlScaling" "verdadeiro"|" falso" Indica se os controles ancorados são dimensionados em uma única passagem. "true" para desativar o dimensionamento em uma única passagem; caso contrário, false. Consulte a seção "Escala de passagem única" nas Observações para obter mais informações.
"DpiAwareness" "PerMonitorV2"|" falso" Indica se um aplicativo reconhece DPI. Defina a chave para "PerMonitorV2" para apoiar a conscientização de Dpi; caso contrário, defina-o como "false". A consciência de DPI é um recurso de aceitação; para aproveitar o alto suporte a DPI do Windows Forms, você deve definir seu valor como "PerMonitorV2". Consulte a seção Comentários para obter mais informações.
"CheckedListBox.DisableHighDpiImprovements" "verdadeiro"|" falso" Indica se o controle aproveita as CheckedListBox melhorias de dimensionamento e layout introduzidas no .NET Framework 4.7. "verdadeiro" para optar por não receber melhorias de dimensionamento e layout; caso contrário, "falso".
"DataGridView.DisableHighDpiImprovements" "verdadeiro"|" falso" Indica se os DataGridView aprimoramentos de dimensionamento e layout de controle introduzidos no .NET Framework 4.7. "verdadeiro" para optar por não participar do conhecimento de DPI; "falso" caso contrário.
"DisableDpiChangedMessageHandling" "verdadeiro"|" falso" "true" para optar por não receber mensagens relacionadas a alterações de escala de DPI; "falso" caso contrário. Consulte a seção Comentários para obter mais informações.
"EnableWindowsFormsHighDpiAutoResizing" "verdadeiro"|" falso" Indica se um aplicativo do Windows Forms é redimensionado automaticamente devido a alterações de dimensionamento de DPI. "true" para permitir o redimensionamento automático; caso contrário, false.
"Form.DisableSinglePassControlScaling" "verdadeiro"|" falso" Indica se o é dimensionado Form em uma única passagem. "true" para desativar o dimensionamento em uma única passagem; caso contrário, false. Consulte a seção "Escala de passagem única" nas Observações para obter mais informações.
"MonthCalendar.DisableSinglePassControlScaling" "verdadeiro"|" falso" Indica se o controle é dimensionado MonthCalendar em uma única passagem. "true" para desativar o dimensionamento em uma única passagem; caso contrário, false. Consulte a seção "Escala de passagem única" nas Observações para obter mais informações.
"Toolstrip.DisableHighDpiImprovements" "verdadeiro"|" falso" Indica se o controle aproveita as ToolStrip melhorias de dimensionamento e layout introduzidas no .NET Framework 4.7. "verdadeiro" para optar por não participar do conhecimento de DPI; "falso" caso contrário.

Elementos filho

Nenhum.

Elementos pai

Elemento Description
<System.Windows.Forms.ApplicationConfigurationSection> Configura o suporte para novos recursos de aplicativos do Windows Forms.

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