model Windows Forms Přidat element konfigurace

  • Článek

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

Syntax

<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ému model Windows Forms přizpůsobitelnou funkci.
value Požadovaný atribut. Hodnota, která se má přiřadit k key.

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", pokud chcete zakázat škálování s jedním průchodem; jinak false. Další informace najdete v části "Měřítko s jedním průchodem" v poznámkách .
"DpiAwareness" "PerMonitorV2"|" false" Označuje, zda aplikace s rozlišením DPI. Nastavte klíč na "PerMonitorV2" pro podporu rozpoznávání dpi; v opačném případě ho nastavte na false. Sledování DPI je funkce výslovného souhlasu; Pokud chcete využít podporu vysoké hodnoty DPI model Windows Forms, měli byste nastavit její hodnotu na PerMonitorV2. Další informace najdete v části Poznámky .
CheckedListBox.DisableHighDpiImprovements "true"|" false" Určuje, zda CheckedListBox ovládací prvek využívá vylepšení měřítka a rozložení zavedených v rozhraní .NET Framework 4.7. "true" pro vyjádření výslovného nesouhlasu se škálováním a vylepšením rozložení; v opačném případě "false".
DataGridView.DisableHighDpiImprovements "true"|" false" Označuje, zda ovládací prvek měřítko DataGridView a rozložení vylepšení zavedená v rozhraní .NET Framework 4.7. "true", pokud se chcete odhlásit z rozpoznávání DPI; Jinak "false".
"DisableDpiChangedMessageHandling" "true"|" false" "true", pokud se chcete odhlásit z příjmu zpráv týkajících se změn rozlišení DPI; Jinak "false". Další informace najdete v části Poznámky .
EnableWindowsFormsHighDpiAutoResizing "true"|" false" Určuje, jestli se velikost aplikace model Windows Forms automaticky změní kvůli změnám rozlišení DPI. "true" pro povolení automatické změny velikosti; jinak false.
"Form.DisableSinglePassControlScaling" "true"|" false" Určuje, jestli Form se škáluje jedním průchodem. "true", pokud chcete zakázat škálování s jedním průchodem; jinak false. Další informace najdete v části "Měřítko s jedním průchodem" v poznámkách .
MonthCalendar.DisableSinglePassControlScaling "true"|" false" Určuje, jestli MonthCalendar je u ovládacího prvku škálováno jedním průchodem. "true", pokud chcete zakázat škálování s jedním průchodem; jinak false. Další informace najdete v části "Měřítko s jedním průchodem" v poznámkách .
"Toolstrip.DisableHighDpiImprovements" "true"|" false" Určuje, zda ToolStrip ovládací prvek využívá vylepšení měřítka a rozložení zavedených v rozhraní .NET Framework 4.7. "true", pokud se chcete odhlásit z rozpoznávání DPI; Jinak "false".

Podřízené prvky

Žádné

Nadřazené prvky

Element Popis
<System.Windows.Forms.ApplicationConfigurationSection> Konfiguruje podporu nových funkcí model Windows Forms aplikací.

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.

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

Přehled podpory model Windows Forms vysoké rozlišení DPI najdete v tématu Podpora vysoké hodnoty DPI v model Windows Forms.

Rozlišení 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 rozlišení DPI, která jsou součástí rozhraní .NET Framework 4.7. Tady jsou některé z nich:

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

  • 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é rozlišení DPI je funkce, která se může hlásit. ve výchozím nastavení je falsehodnota DpiAwareness . Podporu rozpoznávání DPI můžete model Windows Forms vyjádřit nastavením hodnoty tohoto klíče v konfiguračním souboru aplikace na PerMonitorV2 . Pokud je zapnuté rozpoznávání DPI, jsou povoleny také všechny jednotlivé funkce DPI. Tady jsou některé z nich:

  • Zprávy se změněnými dpi, které jsou řízeny DisableDpiChangedMessageHandling klíčem .

  • Dynamická podpora DPI, která je řízena klávesou EnableWindowsFormsHighDpiAutoResizing .

  • Škálování jednoduchého řízení, které je řízeno klávesou Form.DisableSinglePassControlScaling pro jednotlivé Form ovládací prvky, AnchorLayout.DisableSinglePassControlScaling klíčem pro ukotvené ovládací prvky a klávesou MonthCalendar.DisableSinglePassControlScaling pro ovládací MonthCalendar prvek.

  • Vylepšení vysokého rozlišení DPI a rozložení, které je řízeno klávesou CheckListBox.DisableHighDpiImprovementsCheckedListBox ovládacího prvku, klávesou DataGridView.DisableHighDpiImprovements pro DataGridView ovládací prvek a klávesou Toolstrip.DisableHighDpiImprovements pro ovládací ToolStrip prvek.

Jedno výchozí nastavení výslovného souhlasu, které poskytuje nastavení DpiAwareness na , PerMonitorV2 je obecně dostačující pro nové model Windows Forms aplikace. Pak ale můžete vyjádřit výslovný nesouhlas s jednotlivými vylepšeními vysokého rozlišení DPI přidáním odpovídajícího klíče do konfiguračního souboru aplikace. Pokud například chcete využívat všechny nové funkce 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 rozlišení DPI v aplikacích model Windows Forms najdete v tématu Podpora vysokého rozlišení 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 v rozlišení DPI. Patří mezi ně DpiChangedAfterParentudálosti , DpiChangedBeforeParenta DpiChanged . Hodnota DisableDpiChangedMessageHandling klíče určuje, jestli 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 jejich š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 některé ovládací prvky byly škálovány více, než bylo nutné. Jednoúčelové škálování by se mělo zakázat jenom v případě, že vaše aplikace závisí na starém chování.

Viz také