AutoSuggestBox.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 = autoSuggestBox.lightDismissOverlayMode;
autoSuggestBox.lightDismissOverlayMode = lightDismissOverlayMode;

Public Property LightDismissOverlayMode As LightDismissOverlayMode

屬性值

LightDismissOverlayMode

列舉值，指定淺色關閉 UI 外部的區域是否變暗。 預設值為 Auto。

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

暫時性 UI，例如 AutoSuggestBox的建議窗格，會在您按一下或點選其外部時關閉。 這稱為「消失關閉」。 「重迭」是指淺色關閉 UI 外部的區域。

根據預設，Xbox 上的「重迭」會變深，而不會在其他裝置系列上變深。 您可以將 LightDismissOverlayMode 設定為 [開啟 ]，讓您的 app 將所有裝置系列上的「重迭」區域變深，或將它設定為 [關閉 ] 以不要將所有裝置系列上的「重迭」區域變暗。

版本相容性

在 Windows 10 1607 版之前，無法使用 LightDismissOverlayMode 屬性。 如果您的應用程式在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後需求區塊中顯示的「引進版本」，您必須設計和測試您的應用程式以考慮此專案。 如需詳細資訊，請參閱 版本調適型程式碼。

若要避免在舊版Windows 10上執行您的應用程式時發生例外狀況，請勿在 XAML 中設定此屬性，或在不執行執行時間檢查的情況下使用它。 此範例示範如何使用 ApiInformation 類別來檢查此屬性是否存在，再加以設定。

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