Skip to content

Commit d04686b

Browse files
authored
Update SystemBackdropHost Spec for clarity
Clarified limitations of SystemBackdrop in WinUI3 compared to WinUI2 and improved wording for better understanding.
1 parent a375cbc commit d04686b

File tree

1 file changed

+2
-3
lines changed

1 file changed

+2
-3
lines changed

specs/SystemBackdropHost Spec.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,10 @@ SystemBackdropHost
44
# Background
55

66
There are some System backdrop materials such as Mica, Acrylic etc that are available in
7-
`Microsoft.UI.Xaml.Media.SystemBackdrop`. Today, its possible to host a system backdrop only at the window level and only for flyouts which makes
8-
it awkward to layer the effect behind individual containers / controls. This have been a major limitation on WinUI3 compared to WinUI2 in achieving the acrylic / mica effects.
7+
`Microsoft.UI.Xaml.Media.SystemBackdrop`. Today, its possible to host a system backdrop only at the window level and only for flyouts, not in a specific container / control level. This have been a major limitation on WinUI3 compared to WinUI2 in achieving the acrylic / mica effects.
98

109
`SystemBackdropHost` is a lightweight `FrameworkElement` that bridges between the XAML tree and the composition
11-
infrastructure required by `SystemBackdrop`. It creates the composition link a backdrop needs, keeps the placement
10+
infrastructure required by `SystemBackdrop`. It creates the required composition components to host the systembackdrop on a specific container, keeps the placement
1211
visual sized to the arranged bounds, and applies the element's `CornerRadius` to the backdrop clip so rounded corners
1312
appear as expected. This control abstracts lot of details for the composition layer and hence make it easy
1413
for WinUI3 developers to implement the acrylic effect in the applications.

0 commit comments

Comments
 (0)