Aracılığıyla paylaş

yapılandırma öğesi ekleme Windows Forms

  • Makale

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

Syntax

<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.

Öznitelikler

Öznitelik Açıklama
key Gerekli öznitelik. Belirli bir Windows Forms özelleştirilebilir özelliğe 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 duyarlı 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 kabul etme özelliğidir; Windows Forms 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 desteği yapılandırılır.

Açıklamalar

.NET Framework 4.7'den başlayarak öğesi, <System.Windows.Forms.ApplicationConfigurationSection> .NET Framework son sürümlerinde eklenen özelliklerden yararlanmak için Windows Forms uygulamaları 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'de 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 .NET Framework hedef sürümleri altında çalışan Windows Forms uygulamalar, .NET Framework 4.7'de sunulan yüksek DPI iyileş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 bir dizi Windows Forms denetiminin ölçeği ve düzeninde MonthCalendar geliştirmelerCheckedListBox.

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 DPI tanıma için Windows Forms 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 anahtarı tarafından MonthCalendar.DisableSinglePassControlScaling denetlenen tek geçişli denetim ölçeklendirmesi MonthCalendar

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

ayarı DpiAwarenessPerMonitorV2 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 ekleyebilirsiniz:

<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 uygulamalarda Yüksek DPI desteğinden yararlanma hakkında daha fazla bilgi için bkz. Windows Forms'de 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 Windows Forms bir uygulamada 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 ö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.