AppBar.LightDismissOverlayMode Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft einen Wert ab, der angibt, ob der Bereich außerhalb einer Benutzeroberfläche mit hellem Schließen abgedunkelt ist, oder legt diesen fest.

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" />

Eigenschaftswert

LightDismissOverlayMode

Ein -Wert der -Enumeration, der angibt, ob der Bereich außerhalb einer Benutzeroberfläche mit hellem Schließen abgedunkelt ist. Der Standardwert ist Auto.

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Vorübergehende Benutzeroberfläche, z. B. ein MenuFlyout oder ein sekundäres Menü in einer Befehlsleiste, wird geschlossen, wenn Sie darauf klicken oder tippen. Dies wird als light-dismiss bezeichnet. "Überlagerung" bezieht sich auf den Bereich außerhalb einer Benutzeroberfläche mit lichtem Hintergrund.

Standardmäßig wird das "Overlay" auf der Xbox abgedunkelt und auf anderen Gerätefamilien nicht abgedunkelt. Sie können LightDismissOverlayMode auf Ein festlegen, damit Ihre App den "Overlay"-Bereich für alle Gerätefamilien verdunkelt, oder sie auf Aus festlegen, um den "Overlay"-Bereich auf allen Gerätefamilien nicht abzudunken.

Versionskompatibilität

Die LightDismissOverlayMode-Eigenschaft ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner als die im Abschnitt "Anforderungen" weiter unten auf dieser Seite angezeigte "eingeführte Version" ist, müssen Sie die App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Versionsadaptiver Code.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um das Vorhandensein dieser Eigenschaft zu überprüfen, bevor Sie sie festlegen.

<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;
    }
}