LightDismissOverlayMode Enum
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.
Defines constants that specify whether the area outside of a light-dismiss UI is darkened.
public enum class LightDismissOverlayMode/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
enum class LightDismissOverlayMode[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
public enum LightDismissOverlayModePublic Enum LightDismissOverlayMode- Inheritance
-
LightDismissOverlayMode
- Attributes
Windows requirements
| Device family |
Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v3.0)
|
Fields
| Name | Value | Description |
|---|---|---|
| Auto | 0 | The device-family the app is running on determines whether the area outside of a light-dismiss UI is darkened. |
| On | 1 | The area outside of a light-dismiss UI is darkened for all device families. |
| Off | 2 | The area outside of a light-dismiss UI is not darkened for all device families. |
Remarks
Transient UI, such as a Flyout or the open drop-down of a ComboBox, 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.