Dela via

Lägg till konfigurationselement för Windows-formulär

  • Artikel

Elementet <add> lägger till en fördefinierad nyckel som anger om din Windows Form-app stöder funktioner som läggs till i Windows Forms-appar i .NET Framework 4.7 eller senare.

Syntax

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

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Attribut beskrivning
key Obligatoriskt attribut. Ett fördefinierat nyckelnamn som motsvarar en viss anpassningsbar funktion i Windows Forms.
value Obligatoriskt attribut. Värdet som ska tilldelas till key.

key attributnamn och associerade värden

key Namn Värden beskrivning
"AnchorLayout.DisableSinglePassControlScaling" "true"|" false" Anger om förankrade kontroller skalas i ett enda pass. "true" för att inaktivera skalning av enkla pass; annars falskt. Mer information finns i avsnittet "Enkel passskalning" i Kommentarer .
"DpiAwareness" "PerMonitorV2"|" false" Anger om ett program är DPI-medvetet. Ange nyckeln till "PerMonitorV2" för att stödja Dpi-medvetenhet. annars ställer du in den på "false". DPI-medvetenhet är en opt-in-funktion; för att dra nytta av Windows Forms höga DPI-stöd bör du ange värdet för "PerMonitorV2". Mer information finns i avsnittet Kommentarer .
"CheckedListBox.DisableHighDpiImprovements" "true"|" false" Anger om CheckedListBox kontrollen utnyttjar skalnings- och layoutförbättringar som introducerades i .NET Framework 4.7. "sant" för att välja bort skalnings- och layoutförbättringar; annars "false".
"DataGridView.DisableHighDpiImprovements" "true"|" false" Anger om förbättringarna av DataGridView kontrollskalning och layout som introducerades i .NET Framework 4.7. "sant" för att välja bort DPI-medvetenhet; "false" annars.
"DisableDpiChangedMessageHandling" "true"|" false" "true" för att välja bort att ta emot meddelanden som rör DPI-skalningsändringar. "false" annars. Mer information finns i avsnittet Kommentarer .
"EnableWindowsFormsHighDpiAutoResizing" "true"|" false" Anger om ett Windows Forms-program ändras automatiskt på grund av DPI-skalningsändringar. "true" för att aktivera automatisk storleksändring; annars falskt.
"Form.DisableSinglePassControlScaling" "true"|" false" Anger om Form skalas i ett enda pass. "true" för att inaktivera skalning med enkel passering; annars falskt. Mer information finns i avsnittet "Enkel passskalning" i Kommentarer .
"MonthCalendar.DisablesinglePassControlScaling" "true"|" false" Anger om MonthCalendar kontrollen skalas i ett enda pass. "true" för att inaktivera skalning med enkel passering; annars falskt. Mer information finns i avsnittet "Enkel passskalning" i Kommentarer .
"Toolstrip.DisableHighDpiImprovements" "true"|" false" Anger om ToolStrip kontrollen utnyttjar skalnings- och layoutförbättringar som introducerades i .NET Framework 4.7. "sant" för att välja bort DPI-medvetenhet; "false" annars.

Underordnade element

Inga.

Överordnade element

Element Description
<System.Windows.Forms.ApplicationConfigurationSection> Konfigurerar stöd för nya windows forms-programfunktioner.

Kommentarer

Från och med .NET Framework 4.7 kan du med elementet <System.Windows.Forms.ApplicationConfigurationSection> konfigurera Windows Forms-program för att dra nytta av funktioner som lagts till i de senaste versionerna av .NET Framework.

Med <System.Windows.Forms.ApplicationConfigurationSection> elementet kan du lägga till ett eller flera underordnade <add> element, som var och en definierar en specifik konfigurationsinställning.

En översikt över stöd för hög DPI för Windows Forms finns i Stöd för hög DPI i Windows-formulär.

DpiAwareness

Windows Forms-appar som körs under Windows-versioner som börjar med Windows 10 Creators Edition och målversioner av .NET Framework från och med .NET Framework 4.7 kan konfigureras för att dra nytta av höga DPI-förbättringar som introduceras i .NET Framework 4.7. Dessa kan vara:

  • Stöd för dynamiska DPI-scenarier där användaren ändrar DPI eller skalningsfaktor när ett Windows Forms-program har startats.

  • Förbättringar av skalning och layout för ett antal Windows Forms-kontroller, till exempel MonthCalendar kontrollen och CheckedListBox kontrollen.

Hög DPI-medvetenhet är en opt-in-funktion; som standard är värdet DpiAwareness för false. Du kan välja att använda Windows Forms stöd för DPI-medvetenhet genom att ange värdet för den här nyckeln till PerMonitorV2 i programkonfigurationsfilen. Om DPI-medvetenhet är aktiverat aktiveras även alla enskilda DPI-funktioner. Dessa kan vara:

  • DPI ändrade meddelanden som styrs av DisableDpiChangedMessageHandling nyckeln.

  • Dynamiskt DPI-stöd, som styrs av EnableWindowsFormsHighDpiAutoResizing nyckeln.

  • Skalning av enkel passkontroll, som styrs av Form.DisableSinglePassControlScaling för enskilda Form kontroller, av AnchorLayout.DisableSinglePassControlScaling nyckeln för förankrade kontroller och av MonthCalendar.DisableSinglePassControlScaling nyckeln för MonthCalendar kontrollen

  • Förbättringar av hög DPI-skalning och layout, som styrs av CheckListBox.DisableHighDpiImprovements nyckeln för CheckedListBox kontrollen, av DataGridView.DisableHighDpiImprovements nyckeln för DataGridView kontrollen och av Toolstrip.DisableHighDpiImprovements nyckeln för ToolStrip kontrollen.

Den enda standardinställningen för opt-in som tillhandahålls av inställningen DpiAwareness är PerMonitorV2 i allmänhet tillräcklig för nya Windows Forms-program. Du kan dock välja bort enskilda förbättringar av hög DPI genom att lägga till motsvarande nyckel i programkonfigurationsfilen. Om du till exempel vill dra nytta av alla nya DPI-funktioner förutom dynamiskT DPI-stöd lägger du till följande i programkonfigurationsfilen:

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

Vanligtvis avregistrerar du dig från en viss funktion eftersom du har valt att hantera den programmatiskt.

Mer information om hur du drar nytta av stöd för hög DPI i Windows Forms-program finns i Hög DPI-support i Windows Forms.

DisableDpiChangedMessageHandling

Från och med .NET Framework 4.7 skapar Windows Forms-kontroller ett antal händelser relaterade till ändringar i DPI-skalning. Dessa inkluderar DpiChangedAfterParenthändelserna , DpiChangedBeforeParentoch DpiChanged . Värdet för DisableDpiChangedMessageHandling nyckeln avgör om dessa händelser genereras i ett Windows Forms-program.

Skalning med enkla pass

Skalning med en eller flera pass påverkar den upplevda svarstiden i användargränssnittet och det visuella utseendet på användargränssnittselement när de skalas. Från och med .NET Framework 4.7 använder Windows Forms enkelpassskalning. I tidigare versioner av .NET Framework utfördes skalning via flera pass, vilket gjorde att vissa kontroller skalades mer än nödvändigt. Skalning med enkel passering bör endast inaktiveras om din app är beroende av det gamla beteendet.

Se även