Window.SystemBackdrop Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the system backdrop to apply to this Window. The backdrop is rendered behind the Window content.
public:
property SystemBackdrop ^ SystemBackdrop { SystemBackdrop ^ get(); void set(SystemBackdrop ^ value); };
SystemBackdrop SystemBackdrop();
void SystemBackdrop(SystemBackdrop value);
public SystemBackdrop SystemBackdrop { get; set; }
var systemBackdrop = window.systemBackdrop;
window.systemBackdrop = systemBackdrop;
Public Property SystemBackdrop As SystemBackdrop
Property Value
The system backdrop to apply to this Window.
Examples
This example shows how to set the SystemBackdrop to use Mica Alt.
<Window
...>
<Window.SystemBackdrop>
<MicaBackdrop Kind="BaseAlt"/>
</Window.SystemBackdrop>
<Grid RowDefinitions="*,*">
<!-- This area has a transparent background, so the Mica
backdrop will be mostly visible. For example, if there are
buttons here, the backdrop will show up in the margins
and gaps between the buttons. -->
<Grid Background="Transparent">
<TextBlock Text="Grid 1"/>
</Grid>
<!-- This area has an opaque background,
so the Mica backdrop won't be visible. -->
<Grid Grid.Row="1" Background="Gray">
<TextBlock Text="Grid 2"/>
</Grid>
</Window>
public MainWindow()
{
this.InitializeComponent();
SystemBackdrop = new MicaBackdrop()
{ Kind = MicaKind.BaseAlt };
}
Remarks
For more information about system backdrops, see Materials in Windows 11.
The backdrop is rendered behind the content specified in Window.Content. If all the content is fully opaque, this backdrop will have no visible effect.