Window.SystemBackdrop Property

Reference

Definition

Namespace:: Microsoft.UI.Xaml

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.

Edit

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

SystemBackdrop

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"></Grid>

        <!-- This area has an opaque background,
         so the Mica backdrop won't be visible. -->
        <Grid Grid.Row="1" Background="Gray"></Grid>
    </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.

Applies to

Share via