SplitView.LightDismissOverlayMode 屬性
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,這個值會指定 淺色關閉 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
列舉值,指定淺色關閉 UI 外部的區域是否變暗。 預設值為 Auto。
裝置系列 |
Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
|
API contract |
Windows.Foundation.UniversalApiContract (已於 v3.0 引進)
|
暫時性 UI,例如 SplitView的開啟窗格,會在按一下或點選它外部時關閉。 這稱為「關閉」。 「重迭」是指淺色關閉 UI 外部的區域。
根據預設,Xbox 上的「重迭」會變暗,而不會在其他裝置系列上變暗。 您可以將 LightDismissOverlayMode 設定為 [開啟 ],讓您的 app 讓所有裝置系列上的「重迭」區域變深,或將其設定為 [關閉 ] 以不要讓所有裝置系列上的「重迭」區域變暗。
LightDismissOverlayMode 屬性在 Windows 10 1607 版之前無法使用。 如果您的 App 在 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;
}
}