Megosztás a következőn keresztül:

Windows Forms – Konfigurációelem hozzáadása

  • Cikk

Az <add> elem egy előre definiált kulcsot ad hozzá, amely meghatározza, hogy a Windows Űrlap alkalmazás támogatja-e a Windows Forms-alkalmazásokhoz a .NET-keretrendszer 4.7-es vagy újabb verziójában hozzáadott funkciókat.

Syntax

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

Attribútumok és elemek

A következő szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik.

Attribútumok

Attribútum Leírás
key Kötelező attribútum. Egy előre definiált kulcsnév, amely egy adott, testre szabható Windows Forms-funkciónak felel meg.
value Kötelező attribútum. A hozzárendelni keykívánt érték.

key attribútumnevek és társított értékek

key név Értékek Leírás
"AnchorLayout.DisableSinglePassControlScaling" "igaz"|" hamis" Azt jelzi, hogy a rögzített vezérlők egyetlen lépésben vannak-e skálázva. "true" (igaz) az egyszeri átmenő skálázás letiltásához; ellenkező esetben hamis. További információért tekintse meg az "Egyátengéses skálázás" szakaszt a Megjegyzések szakaszban.
"DpiAwareness" "PerMonitorV2"|" hamis" Azt jelzi, hogy egy alkalmazás DPI-vel rendelkezik-e. Állítsa a kulcsot "PerMonitorV2" értékre a Dpi-tudatosság támogatásához; ellenkező esetben állítsa "false" (hamis) értékre. A DPI-tudatosság egy opt-in funkció; A Windows Forms magas DPI-támogatásának kihasználásához állítsa az értékét "PerMonitorV2" értékre. További információért tekintse meg a Megjegyzések szakaszt.
"CheckedListBox.DisableHighDpiImprovements" "igaz"|" hamis" Azt jelzi, hogy a vezérlő kihasználja-e a CheckedListBox .NET-keretrendszer 4.7-ben bevezetett skálázási és elrendezési fejlesztéseket. "true" (igaz) a skálázási és elrendezési fejlesztések letiltásához; egyéb esetben "false" (hamis).
"DataGridView.DisableHighDpiImprovements" "igaz"|" hamis" Azt jelzi, hogy a DataGridView vezérlő skálázási és elrendezési fejlesztései a .NET-keretrendszer 4.7-ben jelentek-e meg. "igaz" a DPI-tudatosság elutasításához; "hamis" egyébként.
"DisableDpiChangedMessageHandling" "igaz"|" hamis" "true" (igaz) a DPI skálázási módosításaival kapcsolatos üzenetek fogadásának letiltásához; "hamis" egyébként. További információért tekintse meg a Megjegyzések szakaszt.
"EnableWindowsFormsHighDpiAutoResizing" "igaz"|" hamis" Azt jelzi, hogy egy Windows Forms-alkalmazás automatikusan átméretezve van-e a DPI skálázási változásai miatt. "true" (igaz) az automatikus átméretezés engedélyezéséhez; ellenkező esetben hamis.
"Form.DisableSinglePassControlScaling" "igaz"|" hamis" Azt jelzi, hogy a Form skálázás egyetlen lépésben történik-e. "true" (igaz) az egyátadásos skálázás letiltásához; ellenkező esetben hamis. További információért tekintse meg az "Egyátengéses skálázás" szakaszt a Megjegyzések szakaszban.
"MonthCalendar.DisableSinglePassControlScaling" "igaz"|" hamis" Azt jelzi, hogy a MonthCalendar vezérlő egyetlen lépésben van-e skálázva. "true" (igaz) az egyátadásos skálázás letiltásához; ellenkező esetben hamis. További információért tekintse meg az "Egyátengéses skálázás" szakaszt a Megjegyzések szakaszban.
"Toolstrip.DisableHighDpiImprovements" "igaz"|" hamis" Azt jelzi, hogy a vezérlő kihasználja-e a ToolStrip .NET-keretrendszer 4.7-ben bevezetett skálázási és elrendezési fejlesztéseket. "igaz" a DPI-tudatosság elutasításához; "hamis" egyébként.

Gyermekelemek

Nincs.

Szülőelemek

Elem Leírás
<System.Windows.Forms.ApplicationConfigurationSection> Konfigurálja az új Windows Forms-alkalmazásfunkciók támogatását.

Megjegyzések

A .NET-keretrendszer 4.7-es verziójától kezdve az <System.Windows.Forms.ApplicationConfigurationSection> elem lehetővé teszi a Windows Forms-alkalmazások konfigurálását, hogy kihasználják a .NET-keretrendszer legújabb kiadásaiban hozzáadott funkciókat.

Az <System.Windows.Forms.ApplicationConfigurationSection> elem lehetővé teszi egy vagy több gyermekelem <add> hozzáadását, amelyek mindegyike meghatározott konfigurációs beállítást határoz meg.

A Windows Forms magas DPI-támogatásának áttekintését lásd: Magas DPI-támogatás a Windows Formsban.

DpiAwareness

A Windows 10 Creators Edition kiadással kezdődő Windows-verziókban futó Windows Forms-alkalmazások és a .NET-keretrendszer célverziói a .NET-keretrendszer 4.7-től kezdve konfigurálhatók úgy, hogy kihasználják a .NET-keretrendszer 4.7-ben bevezetett magas DPI-fejlesztések előnyeit. Ezek közé tartoznak:

  • Olyan dinamikus DPI-forgatókönyvek támogatása, amelyekben a felhasználó módosítja a DPI-t vagy a méretezési tényezőt egy Windows Forms-alkalmazás elindítása után.

  • Számos Windows Forms-vezérlő skálázásának és elrendezésének fejlesztései, például a MonthCalendar vezérlő és a CheckedListBox vezérlő.

A magas DPI-tudatosság egy opt-in funkció; alapértelmezés szerint az érték DpiAwareness az false. Az alkalmazáskonfigurációs fájlban a kulcs PerMonitorV2 értékének beállításával engedélyezheti a Windows Forms DPI-tudatosságának támogatását. Ha a DPI-tudatosság engedélyezve van, minden egyes DPI-funkció is engedélyezve van. Ezek közé tartoznak:

  • A DPI módosította az üzeneteket, amelyeket a DisableDpiChangedMessageHandling kulcs vezérel.

  • Dinamikus DPI-támogatás, amelyet a EnableWindowsFormsHighDpiAutoResizing kulcs vezérel.

  • Egyátadásos vezérlés skálázása, amelyet az Form.DisableSinglePassControlScaling egyes Form vezérlők, a AnchorLayout.DisableSinglePassControlScaling rögzített vezérlők kulcsa és a MonthCalendar.DisableSinglePassControlScaling MonthCalendar vezérlő kulcsa vezérel

  • Magas DPI-méretezési és elrendezési fejlesztések, amelyeket a CheckListBox.DisableHighDpiImprovements vezérlő kulcsa CheckedListBox , a DataGridView.DisableHighDpiImprovements vezérlő kulcsa DataGridView és a Toolstrip.DisableHighDpiImprovements ToolStrip vezérlő kulcsa vezérel.

A beállítás DpiAwareness PerMonitorV2 által biztosított egyetlen alapértelmezett jóváhagyási beállítás általában megfelelő az új Windows Forms-alkalmazásokhoz. Ezután azonban kikapcsolhatja az egyes magas DPI-fejlesztéseket úgy, hogy hozzáadja a megfelelő kulcsot az alkalmazás konfigurációs fájljához. Ha például a dinamikus DPI-támogatás kivételével az összes új DPI-funkciót ki szeretné használni, az alábbiakat kell hozzáadnia az alkalmazás konfigurációs fájljához:

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

Általában azért hagyja ki egy adott funkciót, mert úgy döntött, hogy programozott módon kezeli.

A Magas DPI-támogatás Windows Forms-alkalmazásokban való kihasználásáról további információt a Magas DPI-támogatás a Windows Formsban című témakörben talál.

DisableDpiChangedMessageHandling

A .NET-keretrendszer 4.7-es verziójától kezdve a Windows Forms-vezérlők számos, a DPI-méretezés változásaival kapcsolatos eseményt vetnek fel. Ezek közé tartoznak a DpiChangedAfterParent, DpiChangedBeforeParentés DpiChanged az események. A kulcs értéke DisableDpiChangedMessageHandling határozza meg, hogy ezek az események egy Windows Forms-alkalmazásban legyenek-e előállítva.

Egyátadásos skálázás

Az egy- vagy többlépéses skálázás hatással van a felhasználói felület érzékelt válaszkészségére és a felhasználói felület elemeinek vizuális megjelenésére a méretezés során. A .NET-keretrendszer 4.7-től kezdődően a Windows Forms egyetlen átmenő skálázást használ. A .NET-keretrendszer korábbi verzióiban a skálázás több átjárón keresztül történt, ami miatt egyes vezérlők a szükségesnél nagyobb mértékben skálázhatók. Az egyátadásos skálázást csak akkor szabad letiltani, ha az alkalmazás a régi viselkedéstől függ.

Lásd még