Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Materiały to efekty wizualne stosowane do powierzchni interfejsu użytkownika w celu tworzenia głębokości, hierarchii i zainteresowania wizualnego. WinUI 3 udostępnia cztery mechanizmy stosowania materiałów, z których każdy jest odpowiedni dla innego scenariusza.
Ważna
AcrylicBrush to akryl wyłącznie w aplikacji — rozmywa zawartość XAML w oknie aplikacji. Nie wyświetla pulpitu ani innych okien za aplikacją. W przypadku efektów przezroczystości pulpitu użyj Window.SystemBackdrop lub SystemBackdropElement.
Którego materiału należy używać?
| Scenario | Materiał | API |
|---|---|---|
| Okno aplikacji z tłem Mica zabarwionym tapetą | Mica | Window.SystemBackdrop = new MicaBackdrop() |
| Okno aplikacji z przezroczystym matowym tłem | Pulpit akrylowy | Window.SystemBackdrop = new DesktopAcrylicBackdrop() |
| Menu wysuwane, wyskakujące lub kontekstowe z tłami akrylowymi | Tło systemowe na powierzchni | Ustaw SystemBackdrop na FlyoutBase, Popup itd. |
| Pasek boczny, panel lub element z micą lub akrylem (nie całe okno) | SystemBackdropElement | kontrolka <SystemBackdropElement> |
| Panel nawigacyjny lub panel treści z efektem rozmycia wewnątrz aplikacji | Akryl w aplikacji | {ThemeResource AcrylicInAppFillColorDefaultBrush} |
Brak materiału (ustawienie domyślne)
Jeśli nie zastosowano żadnego materiału, tło okna jest stałym kolorem narysowanym z aktywnego światła lub ciemnego motywu — bez rozmycia ani przezroczystości.
Materiały opierają się na efektach kompositora, które wymagają obsługi sprzętu i preferencji użytkownika. WinUI 3 powraca z wdziękiem do solidnego koloru, gdy nie można renderować materiału:
-
Remote Desktop lub maszyn wirtualnych — komponator nie może mieszać się z zawartością pulpitu za pośrednictwem protokołu RDP, więc
SystemBackdropmateriały wracają automatycznie. - Niewystarczająca ilość sprzętu graficznego — Mica i Desktop Akryl wymagają directX 11 i odpowiedniej pamięci procesora GPU. Urządzenia, które nie osiągają wymaganego progu, przełączają się na jednolity kolor motywu.
-
Efekty przezroczystości wyłączone — jeśli użytkownik wyłączy Efekty przezroczystości w Ustawienia> Personalizacja> Kolory, wszystkie
SystemBackdropmateriały iAcrylicBrushprzyjmują swoje jednolite odpowiedniki. -
Oszczędzanie baterii jest aktywne — Windows wyłącza efekt akrylowy (
DesktopAcrylicBackdropiAcrylicBrush), gdy funkcja Oszczędzanie baterii jest włączona. Nie ma to wpływu na micę. - Tryb wysokiego kontrastu — wszystkie materiały są wyłączane; zamiast nich system stosuje kolory motywu wysokiego kontrastu.
Aplikacja nie musi wykrywać tych warunków — interfejsy API automatycznie obsługują powrót rezerwowy. Upewnij się, że każde skonfigurowane tło motywu lub FallbackColor dobrze wygląda jako jednolity kolor.
Mica
Mica wkomponowuje kolor tapety pulpitu użytkownika w stonowane, spersonalizowane tło. Jest ona przeznaczona dla głównego tła okna aplikacji, szczególnie w obszarach paska tytułu i okienka nawigacji.
-
API:
Window.SystemBackdrop = new MicaBackdrop() -
Warianty:
MicaKind.Base(wartość domyślna) lubMicaKind.BaseAlt(lżejsza, dla powierzchni pomocniczych) - Windows wersja: tylko Windows 11. Przechodzi na jednolity kolor motywu w systemie Windows 10.
Pulpit akrylowy
Efekt Acrylic na pulpicie pokazuje dynamiczny, rozmyty widok pulpitu i zawartości znajdujących się za oknem aplikacji, tworząc efekt oszronionego szkła.
-
API:
Window.SystemBackdrop = new DesktopAcrylicBackdrop() -
Warianty:
DesktopAcrylicKind.Base(bardziej nieprzezroczyste) lubDesktopAcrylicKind.Thin(bardziej przezroczyste) - Windows wersja: Windows 10 (kompilacja 17763) i nowsze.
Akryl można również stosować do powierzchni tymczasowych — ustaw SystemBackdrop dla FlyoutBase, Popup, MenuFlyoutPresenter lub CommandBarFlyoutCommandBar. Pełną listę znajdziesz w sekcji Tła systemowe.
SystemBackdropElement
SystemBackdropElement nakłada materiał Mica lub Desktop Acrylic z kompozytora systemowego na określony element XAML — a nie na całe okno. Użyj go, gdy pasek boczny, panel lub karta potrzebuje własnego tła Mica lub Akrylu niezależnie od reszty okna.
- Minimalny zestaw SDK: Zestaw SDK do aplikacji systemu Windows 1.6.3
- Aby uzyskać szczegółowe informacje i przykłady kodu, zobacz Stosowanie tła systemu do dowolnego elementu XAML.
Acrylic wewnątrz aplikacji (AcrylicBrush)
AcrylicBrush rozmywa zawartość XAML w oknie aplikacji. Nie wyświetla pulpitu ani innych okien przez powierzchnię. Użyj tego do paneli nawigacyjnych, pasków bocznych lub paneli treści wszędzie tam, gdzie chcesz uzyskać półprzezroczysty efekt wewnątrz aplikacji.
-
Interfejs API: zastosuj
{ThemeResource AcrylicInAppFillColorDefaultBrush}do elementuBackgroundlub zdefiniuj niestandardowyAcrylicBrushelement za pomocąTintColor,TintOpacityiTintLuminosityOpacity. - Właściwość UWP
BackgroundSource = HostBackdropnie jest dostępna w WinUI 3. - Aby uzyskać szczegółowe informacje i przykłady kodu, zobacz Akryl w aplikacji.