DatePicker.LightDismissOverlayMode 属性

定义

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

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

void LightDismissOverlayMode(LightDismissOverlayMode value);
public LightDismissOverlayMode LightDismissOverlayMode { get; set; }
var lightDismissOverlayMode = datePicker.lightDismissOverlayMode;
datePicker.lightDismissOverlayMode = lightDismissOverlayMode;
Public Property LightDismissOverlayMode As LightDismissOverlayMode

属性值

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

Windows 要求

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

注解

暂时性 UI(例如 DatePicker 的打开的 DatePickerFlyout)在它外部单击或点击时关闭。 这称为轻型消除。 “覆盖”是指浅色消除 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.DatePicker", "LightDismissOverlayMode"))
    {
        datePicker1.LightDismissOverlayMode = LightDismissOverlayMode.On;
    }
}

适用于