SplitView.LightDismissOverlayMode 属性

定义

命名空间:

Windows.UI.Xaml.Controls

获取或设置一个值，该值指定是否将 浅色消除 UI 外部的区域变暗。

public:
 property LightDismissOverlayMode LightDismissOverlayMode { LightDismissOverlayMode get(); void set(LightDismissOverlayMode value); };

LightDismissOverlayMode LightDismissOverlayMode();

void LightDismissOverlayMode(LightDismissOverlayMode value);

public LightDismissOverlayMode LightDismissOverlayMode { get; set; }

var lightDismissOverlayMode = splitView.lightDismissOverlayMode;
splitView.lightDismissOverlayMode = lightDismissOverlayMode;

Public Property LightDismissOverlayMode As LightDismissOverlayMode

属性值

LightDismissOverlayMode

枚举的一个值，该值指定是否将浅色消除 UI 外部的区域变暗。 默认值为 “自动”。

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

注解

暂时性 UI（如 SplitView 的打开窗格）在单击或点击它外部时关闭。 这称为轻型消除。 “覆盖”是指浅色消除 UI 外部的区域。

默认情况下，“覆盖层”在 Xbox 上变暗，在其他设备系列上不变暗。 可以将 LightDismissOverlayMode 设置为 “开” ，以使应用在所有设备系列上的“覆盖”区域变暗，或将其设置为 “关闭 ”以不使所有设备系列上的“覆盖”区域变暗。

版本兼容性

LightDismissOverlayMode 属性在 Windows 10 版本 1607 之前不可用。 如果 Microsoft Visual Studio 中应用的“最低平台版本”设置小于本页稍后的“要求”块中显示的“引入版本”，则必须设计和测试应用以考虑到这一点。 有关详细信息，请参阅 版本自适应代码。

若要避免在以前版本的 Windows 10 上运行应用时出现异常，请不要在 XAML 中设置此属性或在未执行运行时检查的情况下使用它。 此示例演示如何使用 ApiInformation 类在设置此属性之前检查此属性是否存在。

 private void MainPage_Loaded(object sender, RoutedEventArgs e)
 {
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.SplitView", "LightDismissOverlayMode"))
    {
        splitView1.LightDismissOverlayMode = LightDismissOverlayMode.On;
    }
}