AppBar.LightDismissOverlayMode Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta un valore che specifica se l'area esterna a un'interfaccia utente di chiusura chiara viene oscurata.

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

Valore della proprietà

LightDismissOverlayMode

Valore dell'enumerazione che specifica se l'area esterna a un'interfaccia utente di chiusura chiara viene oscurata. Il valore predefinito è Auto.

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Commenti

Interfaccia utente temporanea, ad esempio un menu MenuFlyout o un menu secondario in una barra dei comandi, chiude quando si fa clic o si tocca fuori. Questo è chiamato light-dismiss. "Sovrapposizione" fa riferimento all'area esterna a un'interfaccia utente di chiusura leggera.

Per impostazione predefinita, la "sovrapposizione" viene oscurata sulla Xbox e non oscurata su altre famiglie di dispositivi. È possibile impostare LightDismissOverlayMode su On per rendere l'app scura l'area "sovrimpressione" in tutte le famiglie di dispositivi oppure impostarla su Disattivata per non oscurare l'area "sovrimpressione" in tutte le famiglie di dispositivi.

Compatibilità tra versioni

La proprietà LightDismissOverlayMode non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è minore della versione "introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per l'account. Per altre informazioni, vedere Codice adattivo della versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. In questo esempio viene illustrato come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

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