AppBar.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 = appBar.lightDismissOverlayMode;
appBar.lightDismissOverlayMode = lightDismissOverlayMode;

Public Property LightDismissOverlayMode As LightDismissOverlayMode

<appBar LightDismissOverlayMode="lightDismissOverlayModeMemberName" />

屬性值

LightDismissOverlayMode

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

Windows 需求

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

備註

暫時性 UI，例如命令列中的 MenuFlyout 或次要功能表，會在您按一下或點選它外部時關閉。 這稱為「關閉」。 「重迭」是指淺色關閉 UI 外部的區域。

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

版本相容性

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

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

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded"/>

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