SplitView.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 della luce 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 = splitView.lightDismissOverlayMode;
splitView.lightDismissOverlayMode = lightDismissOverlayMode;

Public Property LightDismissOverlayMode As LightDismissOverlayMode

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

L'interfaccia utente temporanea, ad esempio il riquadro aperto di un controllo SplitView, si chiude quando si fa clic o si tocca all'esterno di esso. Questo è chiamato light-dismiss. "Overlay" si riferisce all'area all'esterno di un'interfaccia utente di chiusura della luce.

Per impostazione predefinita, la "sovrimpressione" viene oscurata su Xbox e non oscurata in altre famiglie di dispositivi. Puoi impostare LightDismissOverlayMode su Sì per rendere l'app oscurare l'area "overlay" in tutte le famiglie di dispositivi oppure impostarla su No per non rendere più scura l'area "overlay" 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 è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la 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. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

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