AppBar.LightDismissOverlayMode Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que especifica se a área fora de uma interface do usuário de descarte claro está escurecida.

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

Valor da propriedade

LightDismissOverlayMode

Um valor da enumeração que especifica se a área fora de uma interface do usuário de descarte claro está escurecida. O padrão é Automático.

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Comentários

A interface do usuário transitória, como um menu MenuFlyout ou secundário em uma barra de comandos, é fechada quando você clica ou toca fora dela. Isso é chamado de light-dismiss. "Sobreposição" refere-se à área fora de uma interface do usuário light-dismiss.

Por padrão, a "sobreposição" é escurecido no Xbox e não escurecido em outras famílias de dispositivos. Você pode definir LightDismissOverlayMode como Ativado para que seu aplicativo escureça a área de "sobreposição" em todas as famílias de dispositivos ou defina-o como Desativado para não escurecer a área de "sobreposição" em todas as famílias de dispositivos.

Compatibilidade de versões

A propriedade LightDismissOverlayMode não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor do que a "versão introduzida" mostrada no bloco Requisitos mais adiante nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

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