Sdílet prostřednictvím

model Windows Forms Přidání elementu konfigurace

  • Článek

Element <add> přidá předdefinovaný klíč, který určuje, jestli aplikace Windows Form podporuje funkce přidané do model Windows Forms aplikací v rozhraní .NET Framework 4.7 nebo novější.

Syntaxe

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut Popis
key Požadovaný atribut. Předdefinovaný název klíče, který odpovídá určité model Windows Forms přizpůsobitelné funkci.
value Požadovaný atribut. Hodnota, ke které keyse má přiřadit .

key názvy atributů a přidružené hodnoty

key Jméno Hodnoty Popis
"AnchorLayout.DisableSinglePassControlScaling" "true"|" false" Určuje, zda jsou ukotvené ovládací prvky škálovány v jednom průchodu. "true" pro zakázání škálování s jedním průchodem; jinak nepravda. Další informace najdete v části Škálování s jedním průchodem v poznámkách .
"DpiAwareness" "PerMonitorV2"|" false" Určuje, jestli aplikace používá DPI. Nastavte klíč na PerMonitorV2 pro podporu povědomí o dpi; v opačném případě ho nastavte na false. Rozpoznávání DPI je opt-in funkce; pokud chcete využít výhod podpory vysokého DPI model Windows Forms, měli byste jeho hodnotu nastavit na "PerMonitorV2". Další informace najdete v části Poznámky .
"CheckedListBox.DisableHighDpiImprovements" "true"|" false" Určuje, jestli CheckedListBox ovládací prvek využívá vylepšení škálování a rozložení zavedená v rozhraní .NET Framework 4.7. "true" pro výslovný nesouhlas se škálováním a vylepšením rozložení; v opačném případě "false".
DataGridView.DisableHighDpiImprovements "true"|" false" Určuje, jestli se vylepšení měřítka DataGridView a rozložení ovládacího prvku zavedla v rozhraní .NET Framework 4.7. "true" pro odhlášení z povědomí o DPI; "false" v opačném případě.
"DisableDpiChangedMessageHandling" "true"|" false" "true" pro odhlášení od příjmu zpráv souvisejících se změnami škálování DPI; "false" v opačném případě. Další informace najdete v části Poznámky .
"EnableWindowsFormsHighDpiAutoResizing" "true"|" false" Určuje, jestli se aplikace model Windows Forms automaticky změní kvůli změnám škálování DPI. "true" pro povolení automatické změny velikosti; jinak nepravda.
"Form.DisableSinglePassControlScaling" "true"|" false" Určuje, jestli Form se škáluje v jednom průchodu. "true" pro zakázání škálování s jedním průchodem; jinak nepravda. Další informace najdete v části Škálování s jedním průchodem v poznámkách .
MonthCalendar.DisableSinglePassControlScaling "true"|" false" Určuje, zda MonthCalendar je ovládací prvek škálován v jednom průchodu. "true" pro zakázání škálování s jedním průchodem; jinak nepravda. Další informace najdete v části Škálování s jedním průchodem v poznámkách .
"Toolstrip.DisableHighDpiImprovements" "true"|" false" Určuje, jestli ToolStrip ovládací prvek využívá vylepšení škálování a rozložení zavedená v rozhraní .NET Framework 4.7. "true" pro odhlášení z povědomí o DPI; "false" v opačném případě.

Podřízené prvky

Nezaokrouhlovat.

Nadřazené prvky

Element (Prvek) Popis
<System.Windows.Forms.ApplicationConfigurationSection> Konfiguruje podporu nových funkcí aplikace model Windows Forms.

Poznámky

Počínaje rozhraním .NET Framework 4.7 umožňuje element nakonfigurovat model Windows Forms aplikace tak, <System.Windows.Forms.ApplicationConfigurationSection> aby využívaly funkce přidané v nedávných verzích rozhraní .NET Framework.

Tento <System.Windows.Forms.ApplicationConfigurationSection> element umožňuje přidat jeden nebo více podřízených <add> prvků, z nichž každý definuje konkrétní nastavení konfigurace.

Přehled podpory model Windows Forms Vysokého DPI najdete v tématu Podpora vysokého DPI v model Windows Forms.

DpiAwareness

model Windows Forms aplikace, které běží ve verzích Windows počínaje verzí Windows 10 Creators Edition a cílovými verzemi rozhraní .NET Framework počínaje rozhraním .NET Framework 4.7, je možné nakonfigurovat tak, aby využívaly výhody vylepšení vysokého DPI zavedeného v rozhraní .NET Framework 4.7. Tady jsou některé z nich:

  • Podpora dynamických scénářů DPI, ve kterých uživatel po spuštění aplikace model Windows Forms změní faktor DPI nebo měřítko.

  • Vylepšení měřítka a rozložení řady ovládacích prvků model Windows Forms, jako MonthCalendar je ovládací prvek a CheckedListBox ovládací prvek.

Vysoké povědomí o DPI je opt-in funkce; ve výchozím nastavení je falsehodnota DpiAwareness . Pokud chcete vyjádřit výslovný souhlas model Windows Forms, můžete nastavit hodnotu tohoto klíče do PerMonitorV2 konfiguračního souboru aplikace. Pokud je povolené rozpoznávání DPI, jsou povoleny také všechny jednotlivé funkce DPI. Tady jsou některé z nich:

  • Zprávy o změně DPI, které jsou řízeny DisableDpiChangedMessageHandling klíčem

  • Podpora dynamického DPI, která je řízena EnableWindowsFormsHighDpiAutoResizing klíčem.

  • Škálování řízení s jedním průchodem, které je řízeno Form.DisableSinglePassControlScaling pro jednotlivé Form ovládací prvky, AnchorLayout.DisableSinglePassControlScaling klíčem pro ukotvené ovládací prvky a MonthCalendar.DisableSinglePassControlScaling klíčem pro MonthCalendar ovládací prvek

  • Vylepšení měřítka a rozložení s vysokým rozlišením DPI, která je řízena CheckListBox.DisableHighDpiImprovements klíčem pro CheckedListBox ovládací prvek, DataGridView.DisableHighDpiImprovements klíčem DataGridView ovládacího prvku a Toolstrip.DisableHighDpiImprovements klíčem ToolStrip ovládacího prvku.

Nastavení jediného výchozího souhlasu poskytovaného nastavením DpiAwareness PerMonitorV2 je obecně přiměřené pro nové aplikace model Windows Forms. Potom ale můžete vyjádřit výslovný nesouhlas s individuálními vylepšeními DPI přidáním odpovídajícího klíče do konfiguračního souboru aplikace. Pokud například chcete využít výhod všech nových funkcí DPI s výjimkou dynamické podpory DPI, přidejte do konfiguračního souboru aplikace následující:

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

Obvykle se odhlásíte z konkrétní funkce, protože jste se rozhodli ji zpracovat programově.

Další informace o využití podpory vysokého DPI v aplikacích model Windows Forms naleznete v tématu Podpora vysokého DPI v model Windows Forms.

DisableDpiChangedMessageHandling

Počínaje rozhraním .NET Framework 4.7 model Windows Forms ovládací prvky vyvolávají řadu událostí souvisejících se změnami ve škálování DPI. Patří sem události DpiChangedAfterParent, DpiChangedBeforeParenta DpiChanged události. Hodnota DisableDpiChangedMessageHandling klíče určuje, zda jsou tyto události vyvolány v aplikaci model Windows Forms.

Škálování s jedním průchodem

Škálování s jedním nebo více průchody ovlivňuje vnímanou odezvu uživatelského rozhraní a vizuální vzhled prvků uživatelského rozhraní při škálování. Počínaje rozhraním .NET Framework 4.7 model Windows Forms používá škálování s jedním průchodem. V předchozích verzích rozhraní .NET Framework bylo škálování provedeno prostřednictvím několika průchodů, což způsobilo, že se některé ovládací prvky škálovaly více, než bylo nutné. Škálování s jedním průchodem by mělo být zakázané jenom v případě, že vaše aplikace závisí na starém chování.

Viz také