Windows uygulamalarındaki malzemeler

Malzemeler derinlik, hiyerarşi ve görsel ilgi alanı oluşturmak için ui yüzeylerine uygulanan görsel efektlerdir. WinUI 3, malzeme uygulamak için her birinin farklı bir senaryoya uygun olduğu dört mekanizma sağlar.

Important

AcrylicBrush, yalnızca uygulama içi akriliktir — uygulama penceresi içindeki XAML içeriğini bulanıklaştırır. Uygulamanın arkasındaki masaüstü veya diğer pencereleri göstermez. Masaüstü şeffaflık efektleri için Window.SystemBackdrop veya SystemBackdropElement kullanın.

Hangi malzemeyi kullanmalıyım?

Scenario Malzeme API
Mica arka planına sahip uygulama penceresi (duvar kağıdı tonlu) Mica Window.SystemBackdrop = new MicaBackdrop()
Şeffaf buzlu cam arka plana sahip uygulama penceresi Masaüstü Akrilik Window.SystemBackdrop = new DesktopAcrylicBackdrop()
Akrilik arka plana sahip açılır menü, açılır pencere veya bağlam menüsü Bir yüzey üzerindeki sistem arka planı SystemBackdrop öğesini FlyoutBase, Popup vb. üzerinde ayarlayın.
Mica veya Akrilik ile kenar çubuğu, panel veya eleman (pencerenin tamamını değil) SystemBackdropElement <SystemBackdropElement> denetimi
Uygulama içi bulanıklaştırma efektine sahip gezinti bölmesi veya içerik paneli Uygulama içi Akrilik {ThemeResource AcrylicInAppFillColorDefaultBrush}

Malzeme yok (varsayılan)

Hiçbir malzeme uygulanmadığında, pencere arka planı etkin açık veya koyu temadan çizilmiş düz bir renktir; bulanıklık veya yarı saydamlık yoktur.

Düz beyaz arka plan gösteren hiçbir malzeme uygulanmadan WinUI 3 uygulama penceresinin ekran görüntüsü.

Malzemeler, donanım desteği ve kullanıcı tercihleri gerektiren compositor efektlerine dayanır. Bir malzeme işlenemediğinde WinUI 3 düzgün bir şekilde düz bir renge geri döner:

  • Uzak Masaüstü veya sanal makineler — birleştirici, RDP üzerinden masaüstü içeriğiyle birleştirme yapamaz; bu nedenle SystemBackdrop materyaller otomatik olarak geri dönüşe geçer.
  • Yetersiz grafik donanımı — Mica ve Masaüstü Akrilik için DirectX 11 ve yeterli GPU belleği gerekir. Eşiği karşılamayan cihazlar düz bir tema rengine geri döner.
  • Saydamlık efektleri devre dışı bırakıldı — Kullanıcı > kapatırsa, tüm > malzemeler ve düz renk alternatiflerine geri döner.
  • Pil Tasarrufu etkin — Windows Pil Tasarrufu açıkken akriliki (DesktopAcrylicBackdrop ve AcrylicBrush) devre dışı bırakır. Mica etkilenmez.
  • Yüksek karşıtlık modu — tüm malzemeler bastırılır; sistem bunun yerine yüksek karşıtlıklı tema renkleri uygular.

Uygulamanızın bu koşulları algılaması gerekmez; API'ler geri dönüşü otomatik olarak işler. Ayarladığınız herhangi bir FallbackColor veya tema arka planının, tek renkli düz bir arka plan olarak da iyi göründüğünden emin olun.

Mica

Mica, kullanıcının masaüstü duvar kağıdı rengini sessiz, kişiselleştirilmiş bir arka plana ekler. Özellikle başlık çubuğu ve gezinti bölmesi alanlarında ana uygulama penceresi arka planı için tasarlanmıştır.

  • API: Window.SystemBackdrop = new MicaBackdrop()
  • Çeşitlemeler: MicaKind.Base (varsayılan) veya MicaKind.BaseAlt (ikincil yüzeyler için daha açık)
  • Windows sürümü: Yalnızca Windows 11. Windows 10 düz tema rengine geri döner.

MicaBackdrop uygulanmış bir WinUI 3 uygulamasının, kullanıcının masaüstü duvar kâğıdı tarafından hafifçe renklendirilmiş, hafif mavi-gri bir arka plan gösteren ekran görüntüsü.

Masaüstü Akrilik

Masaüstü Akrilik, masaüstü ve uygulama penceresinin arkasındaki içeriğin canlı, bulanık bir görünümünü gösterir ve buzlu cam bir görünüm oluşturur.

  • API: Window.SystemBackdrop = new DesktopAcrylicBackdrop()
  • Çeşitlemeler: DesktopAcrylicKind.Base (daha fazla opak) veya DesktopAcrylicKind.Thin (daha saydam)
  • Windows sürümü: Windows 10 (derleme 17763) ve üzeri.

DesktopAcrylicBackdrop uygulanmış, pencerenin arkasındaki masaüstü içeriğinde buzlu cam bulanıklık efektini gösteren bir WinUI 3 uygulamasının ekran görüntüsü.

Akrilik, geçici yüzeylere de uygulanabilir — SystemBackdrop, FlyoutBase, Popup veya MenuFlyoutPresenter için CommandBarFlyoutCommandBar ayarlayın. Tam liste için bkz . Sistem arka planları .

SystemBackdropElement

SystemBackdropElement, işletim sistemi birleştiricisinden alınan Mica ya da Desktop Acrylic materyalini pencerenin tamamına değil, belirli bir XAML öğesine uygular. Kenar çubuğu, panel veya kartın pencerenin geri kalanından bağımsız olarak kendi Mica veya Akrilik arka planına ihtiyacı olduğunda bunu kullanın.

Uygulama içi Akrilik (AcrylicBrush)

AcrylicBrush uygulama penceresinde XAML içeriğini bulanıklaştırıyor. Masaüstünü veya diğer pencereleri yüzeyin içinden göstermez. Yarı saydam uygulama içi efekt istediğiniz gezinti bölmeleri, kenar çubukları veya içerik panelleri için bunu kullanın.

  • API: {ThemeResource AcrylicInAppFillColorDefaultBrush} öğesini bir Background öğesine uygulayın veya AcrylicBrush, TintColor ve TintOpacity ile özel bir TintLuminosityOpacity tanımlayın.
  • UWP BackgroundSource = HostBackdrop özelliği WinUI 3'te kullanılamaz.
  • Ayrıntılar ve kod örnekleri için Uygulama içi akrilik bölümüne bakın.

Uygulama penceresinde XAML içeriğini bulanıklaştıran yarı saydam bir paneli gösteren Akrilik Fırça uygulanmış bir WinUI 3 uygulamasının ekran görüntüsü.

  • Last updated on