Delen via

Windows Forms- configuratie-element toevoegen

  • Artikel

Het <add> element voegt een vooraf gedefinieerde sleutel toe die aangeeft of uw Windows Form-app functies ondersteunt die zijn toegevoegd aan Windows Forms-apps in .NET Framework 4.7 of hoger.

Syntaxis

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk Beschrijving
key Vereist kenmerk. Een vooraf gedefinieerde sleutelnaam die overeenkomt met een bepaalde aanpasbare functie van Windows Forms.
value Vereist kenmerk. De waarde waaraan moet worden toegewezen key.

key kenmerknamen en bijbehorende waarden

key naam Waarden Beschrijving
"AnchorLayout.DisableSinglePassControlScaling" "true"|" onwaar" Hiermee wordt aangegeven of verankerde besturingselementen in één pas worden geschaald. "true" om schalen met één wachtwoord uit te schakelen; anders, onwaar. Zie de sectie Single Pass Scaling in de Opmerkingen voor meer informatie.
"DpiAwareness" "PerMonitorV2"|" onwaar" Geeft aan of een toepassing DPI-bewust is. Stel de sleutel in op 'PerMonitorV2' om dpi-bewustzijn te ondersteunen; anders stelt u deze in op 'false'. DPI-bewustzijn is een opt-in-functie; als u wilt profiteren van de hoge DPI-ondersteuning van Windows Forms, moet u de waarde ervan instellen op 'PerMonitorV2'. Zie de sectie Opmerkingen voor meer informatie.
"CheckedListBox.DisableHighDpiImprovements" "true"|" onwaar" Hiermee wordt aangegeven of het CheckedListBox besturingselement profiteert van verbeteringen in schalen en indelingen die zijn geïntroduceerd in .NET Framework 4.7. "waar" om af te zien van verbeteringen in schaalaanpassing en indeling; anders is 'false'.
"DataGridView.DisableHighDpiImprovements" "true"|" onwaar" Geeft aan of de verbeteringen voor het schalen en de indeling van besturingselementen DataGridView die zijn geïntroduceerd in .NET Framework 4.7. "true" om af te zien van DPI-bewustzijn; 'false' anders.
"DisableDpiChangedMessageHandling" "true"|" onwaar" "true" om geen berichten te ontvangen met betrekking tot wijzigingen in DPI-schaalaanpassing; 'false' anders. Zie de sectie Opmerkingen voor meer informatie.
"EnableWindowsFormsHighDpiAutoResizing" "true"|" onwaar" Hiermee wordt aangegeven of het formaat van een Windows Forms-toepassing automatisch wordt gewijzigd vanwege wijzigingen in DPI-schaalaanpassing. "true" om het automatisch wijzigen van het formaat in te schakelen; anders, onwaar.
"Form.DisableSinglePassControlScaling" "true"|" onwaar" Hiermee wordt aangegeven of de Form schaal van één wachtwoord is aangepast. "true" om schalen met één wachtwoord uit te schakelen; anders, onwaar. Zie de sectie Single Pass Scaling in de Opmerkingen voor meer informatie.
"MonthCalendar.DisableSinglePassControlScaling" "true"|" onwaar" Hiermee wordt aangegeven of het MonthCalendar besturingselement in één pas wordt geschaald. "true" om schalen met één wachtwoord uit te schakelen; anders, onwaar. Zie de sectie Single Pass Scaling in de Opmerkingen voor meer informatie.
"Toolstrip.DisableHighDpiImprovements" "true"|" onwaar" Hiermee wordt aangegeven of het ToolStrip besturingselement profiteert van verbeteringen in schalen en indelingen die zijn geïntroduceerd in .NET Framework 4.7. "true" om af te zien van DPI-bewustzijn; 'false' anders.

Onderliggende elementen

Geen.

Bovenliggende elementen

Element Beschrijving
<System.Windows.Forms.ApplicationConfigurationSection> Hiermee configureert u ondersteuning voor nieuwe Windows Forms-toepassingsfuncties.

Opmerkingen

Vanaf .NET Framework 4.7 kunt u met het <System.Windows.Forms.ApplicationConfigurationSection> element Windows Forms-toepassingen configureren om te profiteren van functies die zijn toegevoegd in recente versies van .NET Framework.

Met <System.Windows.Forms.ApplicationConfigurationSection> het element kunt u een of meer onderliggende <add> elementen toevoegen, die elk een specifieke configuratie-instelling definiëren.

Zie High DPI-ondersteuning voor Windows Forms in Windows Forms voor een overzicht van de ondersteuning voor Hoge DPI in Windows Forms.

DpiAwareness

Windows Forms-apps die worden uitgevoerd onder Windows-versies vanaf Windows 10 Creators Edition en doelversies van het .NET Framework vanaf .NET Framework 4.7 kunnen worden geconfigureerd om te profiteren van hoge DPI-verbeteringen die zijn geïntroduceerd in .NET Framework 4.7. Deze omvatten:

  • Ondersteuning voor dynamische DPI-scenario's waarin de gebruiker de DPI of schaalfactor wijzigt nadat een Windows Forms-toepassing is gestart.

  • Verbeteringen in het schalen en de indeling van een aantal Besturingselementen voor Windows Forms, zoals het MonthCalendar besturingselement en het CheckedListBox besturingselement.

Hoge DPI-kennis is een opt-in-functie; standaard is de waarde van DpiAwareness .false U kunt zich aanmelden voor de ondersteuning van Windows Forms voor DPI-bewustzijn door de waarde van deze sleutel PerMonitorV2 in te stellen in het configuratiebestand van de toepassing. Als DPI-bewustzijn is ingeschakeld, worden alle afzonderlijke DPI-functies ook ingeschakeld. Deze omvatten:

  • DPI heeft berichten gewijzigd, die worden beheerd door de DisableDpiChangedMessageHandling sleutel.

  • Dynamische DPI-ondersteuning, die wordt beheerd door de EnableWindowsFormsHighDpiAutoResizing sleutel.

  • Schaalaanpassing van besturingselementen met één wachtwoord, die wordt beheerd door de Form.DisableSinglePassControlScaling voor afzonderlijke Form besturingselementen, door de AnchorLayout.DisableSinglePassControlScaling sleutel voor verankerde besturingselementen en door de MonthCalendar.DisableSinglePassControlScaling sleutel voor het MonthCalendar besturingselement

  • Hoge DPI-schaal- en indelingsverbeteringen, die worden bepaald door de CheckListBox.DisableHighDpiImprovements sleutel voor het CheckedListBox besturingselement, door de DataGridView.DisableHighDpiImprovements sleutel voor het DataGridView besturingselement en door de Toolstrip.DisableHighDpiImprovements sleutel voor het ToolStrip besturingselement.

De standaardinstelling voor opt-ins die wordt geboden door de instelling DpiAwareness PerMonitorV2 is over het algemeen voldoende voor nieuwe Windows Forms-toepassingen. U kunt zich echter afmelden voor afzonderlijke hoge DPI-verbeteringen door de bijbehorende sleutel toe te voegen aan het toepassingsconfiguratiebestand. Als u bijvoorbeeld wilt profiteren van alle nieuwe DPI-functies, met uitzondering van dynamische DPI-ondersteuning, voegt u het volgende toe aan uw toepassingsconfiguratiebestand:

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

Normaal gesproken kiest u zich voor een bepaalde functie, omdat u ervoor hebt gekozen deze programmatisch af te handelen.

Zie High DPI-ondersteuning in Windows Forms voor meer informatie over het gebruik van hoge DPI-ondersteuning in Windows Forms-toepassingen.

DisableDpiChangedMessageHandling

Vanaf .NET Framework 4.7 genereren Windows Forms-besturingselementen een aantal gebeurtenissen met betrekking tot wijzigingen in DPI-schaalaanpassing. Dit zijn onder andere de DpiChangedAfterParent, DpiChangedBeforeParenten DpiChanged gebeurtenissen. De waarde van de DisableDpiChangedMessageHandling sleutel bepaalt of deze gebeurtenissen worden gegenereerd in een Windows Forms-toepassing.

Schaalaanpassing met één wachtwoord

Eenmalige of meervoudige schaalaanpassing beïnvloedt de waargenomen reactiesnelheid van de gebruikersinterface en het visuele uiterlijk van elementen van de gebruikersinterface wanneer ze worden geschaald. Vanaf .NET Framework 4.7 maakt Windows Forms gebruik van schaalaanpassing met één wachtwoord. In eerdere versies van .NET Framework is schalen uitgevoerd via meerdere passen, waardoor sommige besturingselementen meer worden geschaald dan nodig was. Schaalaanpassing met één wachtwoord mag alleen worden uitgeschakeld als uw app afhankelijk is van het oude gedrag.

Zie ook