| -api-id | -api-type |
|---|---|
P:Windows.UI.Xaml.Controls.AppBar.LightDismissOverlayMode |
winrt property |
Gets or sets a value that specifies whether the area outside of a light-dismiss UI is darkened.
<appBar LightDismissOverlayMode="lightDismissOverlayModeMemberName" />- lightDismissOverlayModeMemberName
- lightDismissOverlayModeMemberNameA named constant of the LightDismissOverlayMode enumeration; for example, On or Off.
Transient UI, such as a MenuFlyout or secondary menu in a command bar, closes when you click or tap outside of it. This is called light-dismiss. "Overlay" refers to the area outside of a light-dismiss UI.
By default, the "overlay" is darkened on the Xbox, and not darkened on other devices families. You can set LightDismissOverlayMode to On to make your app darken the "overlay" area on all device families, or set it to Off to not darken the "overlay" area on all device families.
The LightDismissOverlayMode property is not available prior to Windows 10, version 1607. If your app’s 'minimum platform version' setting in Microsoft Visual Studio is less than the 'introduced version' shown in the Requirements block later in this page, you must design and test your app to account for this. For more info, see Version adaptive code.
To avoid exceptions when your app runs on previous versions of Windows 10, do not set this property in XAML or use it without performing a runtime check. This example shows how to use the ApiInformation class to check for the presence of this property before you set it.
<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded"/>private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBar", "LightDismissOverlayMode"))
{
commandBar1.LightDismissOverlayMode = LightDismissOverlayMode.On;
}
}