Compartilhar via


CalendarDatePicker.LightDismissOverlayMode Propriedade

Definição

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 = calendarDatePicker.lightDismissOverlayMode;
calendarDatePicker.lightDismissOverlayMode = lightDismissOverlayMode;
Public Property LightDismissOverlayMode As LightDismissOverlayMode

Valor da propriedade

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 a exibição de calendário aberta de um CalendarDatePicker, é 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.

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

Aplica-se a