Windows Forms Yapılandırma Öğesi Ekle

  • Makale

öğesi, <add> Windows Form uygulamanızın .NET Framework 4.7 veya sonraki sürümlerde Windows Forms uygulamalarına eklenen özellikleri destekleyip desteklemediğini belirten önceden tanımlanmış bir anahtar ekler.

Sözdizimi

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

Öznitelikler ve öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Özellikler

Öznitelik Açıklama
key Gerekli öznitelik. Belirli bir Windows Forms özelleştirilebilir özelliğine karşılık gelen önceden tanımlanmış anahtar adı.
value Gerekli öznitelik. öğesine atanacak keydeğer.

key öznitelik adları ve ilişkili değerler

key ad Değerler Açıklama
"AnchorLayout.DisableSinglePassControlScaling" "true"|" false" Bağlantılı denetimlerin tek bir geçişte ölçeklendirilip ölçeklendirilmediğini gösterir. Tek geçişli ölçeklendirmeyi devre dışı bırakmak için "true" ; aksi takdirde false. Daha fazla bilgi için Açıklamalar'daki "Tek geçişli ölçeklendirme" bölümüne bakın.
"DpiAwareness" "PerMonitorV2"|" false" Bir uygulamanın DPI kullanan olup olmadığını gösterir. Dpi farkındalığını desteklemek için anahtarı "PerMonitorV2" olarak ayarlayın; aksi takdirde, "false" olarak ayarlayın. DPI farkındalığı bir katılım özelliğidir; Windows Forms'un yüksek DPI desteğinden yararlanmak için değerini "PerMonitorV2" olarak ayarlamanız gerekir. Daha fazla bilgi için Açıklamalar bölümüne bakın.
"CheckedListBox.DisableHighDpiImprovements" "true"|" false" Denetimin CheckedListBox .NET Framework 4.7'de sunulan ölçeklendirme ve düzen geliştirmelerinden yararlanıp yararlanmadığını gösterir. Ölçeklendirme ve düzen geliştirmelerini geri çevirmek için "true"; aksi takdirde , "false".
"DataGridView.DisableHighDpiImprovements" "true"|" false" .NET Framework 4.7'de sunulan denetim ölçeklendirme ve düzen geliştirmelerinin olup olmadığını DataGridView gösterir. DPI farkındalığını geri çevirmek için "true"; "false" aksi takdirde.
"DisableDpiChangedMessageHandling" "true"|" false" DPI ölçeklendirme değişiklikleriyle ilgili iletileri almayı geri çevirmek için "true"; "false" aksi takdirde. Daha fazla bilgi için Açıklamalar bölümüne bakın.
"EnableWindowsFormsHighDpiAutoResizing" "true"|" false" DPI ölçeklendirme değişiklikleri nedeniyle bir Windows Forms uygulamasının otomatik olarak yeniden boyutlandırılıp boyutlandırılmadığını gösterir. Otomatik yeniden boyutlandırmayı etkinleştirmek için "true" ; aksi takdirde false.
"Form.DisableSinglePassControlScaling" "true"|" false" öğesinin Form tek bir geçişte ölçeklendirilip ölçeklendirilmediğini gösterir. Tek geçişli ölçeklendirmeyi devre dışı bırakmak için "true" ; aksi takdirde false. Daha fazla bilgi için Açıklamalar'daki "Tek geçişli ölçeklendirme" bölümüne bakın.
"MonthCalendar.DisableSinglePassControlScaling" "true"|" false" Denetimin MonthCalendar tek bir geçişte ölçeklendirilip ölçeklendirilmediğini gösterir. Tek geçişli ölçeklendirmeyi devre dışı bırakmak için "true" ; aksi takdirde false. Daha fazla bilgi için Açıklamalar'daki "Tek geçişli ölçeklendirme" bölümüne bakın.
"Toolstrip.DisableHighDpiImprovements" "true"|" false" Denetimin ToolStrip .NET Framework 4.7'de sunulan ölçeklendirme ve düzen geliştirmelerinden yararlanıp yararlanmadığını gösterir. DPI farkındalığını geri çevirmek için "true"; "false" aksi takdirde.

Alt öğeleri

Yok.

Üst öğeler

Öğe Açıklama
<System.Windows.Forms.ApplicationConfigurationSection> Yeni Windows Forms uygulama özellikleri için destek yapılandırılır.

Açıklamalar

.NET Framework 4.7'den başlayarak, <System.Windows.Forms.ApplicationConfigurationSection> öğesi Windows Forms uygulamalarını .NET Framework'ün son sürümlerinde eklenen özelliklerden yararlanacak şekilde yapılandırmanıza olanak tanır.

<System.Windows.Forms.ApplicationConfigurationSection> öğesi, her biri belirli bir yapılandırma ayarını tanımlayan bir veya daha fazla alt <add> öğe eklemenize olanak tanır.

Windows Forms Yüksek DPI desteğine genel bakış için bkz . Windows Forms'da Yüksek DPI Desteği.

DpiAwareness

Windows 10 Creators Edition ile başlayan Windows sürümleri ve .NET Framework 4.7 ile başlayan hedef .NET Framework sürümleri altında çalışan Windows Forms uygulamaları, .NET Framework 4.7'de sunulan yüksek DPI geliştirmelerinden yararlanacak şekilde yapılandırılabilir. Bu modüller şunlardır:

  • Bir Windows Forms uygulaması başlatıldıktan sonra kullanıcının DPI'yi veya ölçek faktörünü değiştirdiği dinamik DPI senaryoları için destek.

  • Denetim ve denetim gibi MonthCalendar bir dizi Windows Forms denetiminin ölçeğinde ve düzeninde yapılan geliştirmeler CheckedListBox .

Yüksek DPI farkındalığı bir kabul etme özelliğidir; varsayılan olarak değeri DpiAwareness şeklindedir false. Bu anahtarın PerMonitorV2 değerini uygulama yapılandırma dosyasında olarak ayarlayarak Windows Forms'un DPI tanıma desteğini kabul edebilirsiniz. DPI farkındalığı etkinleştirilirse, tek tek tüm DPI özellikleri de etkinleştirilir. Bu modüller şunlardır:

  • DPI, anahtar tarafından DisableDpiChangedMessageHandling denetlenen iletileri değiştirdi.

  • Anahtar tarafından EnableWindowsFormsHighDpiAutoResizing denetlenen dinamik DPI desteği.

  • Tek tek Form denetimler için, bağlantılı denetimlerin Form.DisableSinglePassControlScaling anahtarı ve denetimin AnchorLayout.DisableSinglePassControlScaling MonthCalendar.DisableSinglePassControlScaling anahtarı tarafından denetlenen tek geçişli denetim ölçeklendirmesi MonthCalendar

  • Denetimin anahtarı, denetimin anahtarı ve denetimin CheckListBox.DisableHighDpiImprovements CheckedListBox DataGridView.DisableHighDpiImprovements anahtarı DataGridView tarafından Toolstrip.DisableHighDpiImprovements ToolStrip denetlenen yüksek DPI ölçeklendirme ve düzen geliştirmeleri.

ayarı DpiAwareness PerMonitorV2 tarafından sağlanan tek varsayılan kabul etme ayarı, yeni Windows Forms uygulamaları için genel olarak yeterlidir. Bununla birlikte, ilgili anahtarı uygulama yapılandırma dosyasına ekleyerek tek tek yüksek DPI geliştirmelerini geri çevirebilirsiniz. Örneğin, dinamik DPI desteği dışındaki tüm yeni DPI özelliklerinden yararlanmak için, uygulama yapılandırma dosyanıza aşağıdakileri eklersiniz:

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

Genellikle belirli bir özelliği program aracılığıyla işlemeyi seçtiğiniz için bu özelliği geri çevirebilirsiniz.

Windows Forms uygulamalarında Yüksek DPI desteğinden yararlanma hakkında daha fazla bilgi için bkz . Windows Forms'da Yüksek DPI Desteği.

DisableDpiChangedMessageHandling

.NET Framework 4.7'den başlayarak, Windows Forms denetimleri DPI ölçeklendirmesindeki değişikliklerle ilgili bir dizi olayı tetikler. Bunlar , DpiChangedBeforeParentve DpiChanged olaylarını DpiChangedAfterParentiçerir. Anahtarın DisableDpiChangedMessageHandling değeri, bu olayların bir Windows Forms uygulamasında tetiklenip tetiklenmeyeceğini belirler.

Tek geçişli ölçeklendirme

Tek veya çok geçişli ölçeklendirme, kullanıcı arabiriminin algılanan yanıt hızını ve kullanıcı arabirimi öğelerinin ölçeklendirildikçe görsel görünümünü etkiler. .NET Framework 4.7'den başlayarak, Windows Forms tek geçişli ölçeklendirme kullanır. .NET Framework'ün önceki sürümlerinde ölçeklendirme birden çok geçiş aracılığıyla gerçekleştirildi ve bu da bazı denetimlerin gerekenden daha fazla ölçeklendirilmesine neden oldu. Tek geçişli ölçeklendirme yalnızca uygulamanız eski davranışa bağlıysa devre dışı bırakılmalıdır.

Ayrıca bkz.