Windows フォームの構成要素を追加します。Windows Forms Add Configuration Element

<add>要素は、Windows フォーム アプリが .NET Framework 4.7 以降の Windows フォーム アプリに追加された機能をサポートしているかどうかを指定する定義済みのキーを追加します。The <add> element adds a predefined key that specifies whether your Windows Form app supports features added to Windows Forms apps in the .NET Framework 4.7 or later.

構文Syntax

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

属性と要素Attributes and elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
key 必須の属性です。Required attribute. 特定の Windows フォームのカスタマイズ可能な機能に対応する定義済みのキー名。A predefined key name that corresponds to a particular Windows Forms customizable feature.
value 必須の属性です。Required attribute. 代入する値keyします。The value to assign to key.

key 属性の名前と関連付けられている値key attribute names and associated values

keykey name Values 説明Description
"AnchorLayout.DisableSinglePassControlScaling""AnchorLayout.DisableSinglePassControlScaling" "true"|"false""true"|"false" 単一のパスで固定されたコントロールをスケーリングするかどうかを示します。Indicates whether anchored controls are scaled in a single pass. スケーリング、1 つを無効にするには"true"を渡すそれ以外の場合、false です。"true" to disable single pass scaling; otherwise, false. 「1 つは、スケーリングを渡す」を参照してください、解説詳細についてはします。See the "Single pass scaling" section in the Remarks for more information.
"DpiAwareness""DpiAwareness" "PerMonitorV2"|"false""PerMonitorV2"|"false" アプリケーションが DPI 対応かどうかを示します。Indicates whether an application is DPI-aware. Dpi 対応; をサポートするには、"PerMonitorV2"にキーを設定します。それ以外の場合、"false"に設定します。Set the key to "PerMonitorV2" to support Dpi awareness; otherwise, set it to "false". DPI 対応は、オプトイン機能です。Windows フォームの高 DPI のサポートを利用するには、"PerMonitorV2"には、その値を設定する必要があります。DPI awareness is an opt-in feature; to take advantage of Windows Forms' high DPI support, you should set its value to "PerMonitorV2". 参照してください、解説詳細についてはします。See the Remarks section for more information.
"CheckedListBox.DisableHighDpiImprovements""CheckedListBox.DisableHighDpiImprovements" "true"|"false""true"|"false" 示すかどうか、CheckedListBoxコントロールは、.NET Framework 4.7 で導入されたスケーリングとレイアウトの機能強化を活用します。Indicates whether the CheckedListBox control takes advantage of scaling and layout improvements introduced in the .NET Framework 4.7. caling とレイアウトの改善をオプトアウトするには"true"それ以外の場合、"false"です。"true" to opt out of caling and layout improvements; otherwise, "false".
"DataGridView.DisableHighDpiImprovements""DataGridView.DisableHighDpiImprovements" "true"|"false""true"|"false" 示すかどうか、 DataGridView .NET Framework 4.7 で導入された機能強化が拡大縮小とレイアウトを制御します。Indicates whether the DataGridView control scaling and layout improvements introduced in the .NET Framework 4.7. DPI 対応; をオプトアウトするには"true""false"それ以外の場合。"true" to opt out of DPI awareness; "false" otherwise.
"DisableDpiChangedMessageHandling""DisableDpiChangedMessageHandling" "true"|"false""true"|"false" DPI スケール変更に関連するメッセージの受信をオプトアウトするには"true""false"それ以外の場合。"true" to opt out of receiving messages related to DPI scaling changes; "false" otherwise. 参照してください、解説詳細についてはします。See the Remarks section for more information.
"EnableWindowsFormsHighDpiAutoResizing""EnableWindowsFormsHighDpiAutoResizing" "true"|"false""true"|"false" Windows フォーム アプリケーションの DPI スケールが変更されたのため自動的にサイズを変更するかどうかを示します。Indicates whether a Windows Forms application is automatically resized due to DPI scaling changes. 自動サイズ変更を有効にするのには"true"それ以外の場合、false です。"true" to enable automatic resizing; otherwise, false.
"Form.DisableSinglePassControlScaling""Form.DisableSinglePassControlScaling" "true"|"false""true"|"false" 示すかどうか、Formは単一のパスでスケーリングされます。Indicates whether the Form is scaled in a single pass. スケーリング、"true"を無効にする単一のパスそれ以外の場合、false です。"true" to disable single-pass scaling; otherwise, false. 「1 つは、スケーリングを渡す」を参照してください、解説詳細についてはします。See the "Single pass scaling" section in the Remarks for more information.
"MonthCalendar.DisableSinglePassControlScaling""MonthCalendar.DisableSinglePassControlScaling" "true"|"false""true"|"false" 示すかどうか、MonthCalendarコントロールが単一のパスでスケーリングします。Indicates whether the MonthCalendar control is scaled in a single pass. スケーリング、"true"を無効にする単一のパスそれ以外の場合、false です。"true" to disable single-pass scaling; otherwise, false. 「1 つは、スケーリングを渡す」を参照してください、解説詳細についてはします。See the "Single pass scaling" section in the Remarks for more information.
"Toolstrip.DisableHighDpiImprovements""Toolstrip.DisableHighDpiImprovements" "true"|"false""true"|"false" 示すかどうか、ToolStripコントロールは、.NET Framework 4.7 で導入されたスケーリングとレイアウトの機能強化を活用します。Indicates whether the ToolStrip control takes advantage of scaling and layout improvements introduced in the .NET Framework 4.7. DPI 対応; をオプトアウトするには"true""false"それ以外の場合。"true" to opt out of DPI awareness; "false" otherwise.

子要素Child elements

なし。None.

親要素Parent elements

要素Element 説明Description
<System.Windows.Forms.ApplicationConfigurationSection> 新しい Windows フォーム アプリケーションの機能のサポートを構成します。Configures support for new Windows Forms application features.

RemarksRemarks

.NET Framework 4.7 を使用すれば、.NET Framework の最近のリリースで追加された機能が利用できる Windows フォームのアプリケーションを、<System.Windows.Forms.ApplicationConfigurationSection> 要素で構成できます。Starting with the .NET Framework 4.7, the <System.Windows.Forms.ApplicationConfigurationSection> element allows you to configure Windows Forms applications to take advantage of features added in recent releases of the .NET Framework.

<System.Windows.Forms.ApplicationConfigurationSection>要素では、1 つまたは複数の子を追加できます。<add>要素は、それぞれが特定の構成設定を定義します。The <System.Windows.Forms.ApplicationConfigurationSection> element allows you to add one or more child <add> elements, each of which defines a specific configuration setting.

Windows フォームの高 DPI サポートの概要については、次を参照してください。 Windows フォームでの高 DPI サポートします。For an overview of Windows Forms High DPI support, see High DPI Support in Windows Forms.

DpiAwarenessDpiAwareness

.NET Framework で導入された 高 DPI 機能強化を活用するために .NET Framework 4.7 以降では Windows 10 Creators Edition と .NET Framework のターゲット バージョン以降の Windows バージョンで実行される Windows フォーム アプリを構成することができます。4.7。Windows Forms apps that run under Windows versions starting with Windows 10 Creators Edition and target versions of the .NET Framework starting with the .NET Framework 4.7 can be configured to take advantage of high DPI improvements introduced in the .NET Framework 4.7. 不足している機能には次が含まれます。These include:

  • Windows フォーム アプリケーションが起動された後に、ユーザー、DPI またはスケール ファクターを変更、動的 DPI シナリオのサポート。Support for dynamic DPI scenarios in which the user changes the DPI or scale factor after a Windows Forms application has been launched.

  • スケーリングとさまざまな Windows フォームのレイアウトの機能強化を制御するなど、MonthCalendarコントロールとCheckedListBoxコントロール。Improvements in the scaling and layout of a number of Windows Forms controls, such as the MonthCalendar control and the CheckedListBox control.

高 DPI 対応は、オプトイン機能です。既定の値でDpiAwarenessfalseします。High DPI awareness is an opt-in feature; by default, the value of DpiAwareness is false. DPI 対応にこのキーの値を設定して Windows フォームのサポートを選択できますPerMonitorV2アプリケーション構成ファイルでします。You can opt into Windows Forms' support for DPI awareness by setting the value of this key to PerMonitorV2 in the application configuration file. DPI 対応を有効にすると、個々 のすべての DPI 機能も有効にします。If DPI awareness is enabled, all individual DPI features are also enabled. 不足している機能には次が含まれます。These include:

  • DPI 変更によって制御される、メッセージ、DisableDpiChangedMessageHandlingキー。DPI changed messages, which are controlled by the DisableDpiChangedMessageHandling key.

  • によって制御される、動的 DPI のサポート、EnableWindowsFormsHighDpiAutoResizingキー。Dynamic DPI support, which is controlled by the EnableWindowsFormsHighDpiAutoResizing key.

  • 単一のパス コントロールがスケーリングによって制御されますが、Form.DisableSinglePassControlScaling個々 のFormコントロールで、 AnchorLayout.DisableSinglePassControlScaling 、アンカー コントロールとキー、MonthCalendar.DisableSinglePassControlScalingのキー、MonthCalendarコントロールSingle-pass control scaling, which is controlled by the Form.DisableSinglePassControlScaling for individual Form controls, by the AnchorLayout.DisableSinglePassControlScaling key for anchored controls, and by the MonthCalendar.DisableSinglePassControlScaling key for the MonthCalendar control

  • 高 DPI スケーリングとレイアウトの機能強化、によって制御される、CheckListBox.DisableHighDpiImprovementsキー、CheckedListBoxコントロールによって、DataGridView.DisableHighDpiImprovementsのキー、DataGridViewコントロール、および、Toolstrip.DisableHighDpiImprovementsのキー、ToolStripコントロール。High DPI scaling and layout improvements, which is controlled by the CheckListBox.DisableHighDpiImprovements key for the CheckedListBox control, by the DataGridView.DisableHighDpiImprovements key for the DataGridView control, and by the Toolstrip.DisableHighDpiImprovements key for the ToolStrip control.

1 つの既定、オプトイン設定は設定によって提供されるDpiAwarenessPerMonitorV2は一般に、新しい Windows フォーム アプリケーションの適切な。The single default opt-in setting provided by setting DpiAwareness to PerMonitorV2 is generally adequate for new Windows Forms applications. ただし、ことができますし、オプトアウトする個々 の高 DPI 機能強化、アプリケーション構成ファイルに対応するキーを追加することで。However, You can then opt out of individual high DPI improvements by adding the corresponding key to the application configuration file. たとえば、動的 DPI のサポートを除くすべての新しい DPI 機能を利用する場合は、アプリケーション構成ファイルには、次を追加します。For example, to take advantage of all the new DPI features except for dynamic DPI support, you would add the following to your application configuration file:

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

通常、オプトアウトする特定の機能をプログラムで処理することを選択したためです。Typically, you opt out of a particular feature because you've chosen to handle it programmatically.

Windows フォーム アプリケーションの高 DPI サポートの利用の詳細については、次を参照してください。 Windows フォームでの高 DPI サポートします。For more information on taking advantage of High DPI support in Windows Forms applications, see High DPI Support in Windows Forms.

DisableDpiChangedMessageHandlingDisableDpiChangedMessageHandling

以降、.NET Framework 4.7 では、Windows フォーム コントロールは、数の DPI スケールでの変更に関連するイベントを発生します。Starting with the .NET Framework 4.7, Windows Forms controls raise a number of events related to changes in DPI scaling. 以下のDpiChangedAfterParentDpiChangedBeforeParent、およびDpiChangedイベント。These include the DpiChangedAfterParent, DpiChangedBeforeParent, and DpiChanged events. 値、DisableDpiChangedMessageHandlingキーは、Windows フォーム アプリケーションで、これらのイベントが発生したかどうかを決定します。The value of the DisableDpiChangedMessageHandling key determines whether these events are raised in a Windows Forms application.

単一パスのスケーリングSingle-pass scaling

調整ので、ユーザー インターフェイスの認識される応答性とユーザー インターフェイス要素の視覚的な外観に影響 1 つまたは複数のパスをスケーリングします。Single or multi-pass scaling influences the perceived responsiveness of the user interface and the visual appearance of user interface elements as they are scaled. 以降、.NET Framework 4.7 では、Windows フォームは、単一のパスのスケーリングを使用します。Starting with the .NET Framework 4.7, Windows Forms uses single pass scaling. .NET Framework の以前のバージョンでスケーリングが必要以上にスケールする一部のコントロールの原因とする複数のパスから実行されました。In previous versions of the .NET Framework, scaling was performed through multiple passes, which caused some controls to be scaled more than was necessary. アプリが古い動作に依存している場合、単一パス scaling を無効のみ必要があります。Single-pass scaling should only be disabled if your app depends on the old behavior.

関連項目See also