AutoSuggestBox.LightDismissOverlayMode Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit une valeur qui spécifie si la zone à l’extérieur d’une interface utilisateur d’assombrie est assombrie.

public:
 property LightDismissOverlayMode LightDismissOverlayMode { LightDismissOverlayMode get(); void set(LightDismissOverlayMode value); };

LightDismissOverlayMode LightDismissOverlayMode();

void LightDismissOverlayMode(LightDismissOverlayMode value);

public LightDismissOverlayMode LightDismissOverlayMode { get; set; }

var lightDismissOverlayMode = autoSuggestBox.lightDismissOverlayMode;
autoSuggestBox.lightDismissOverlayMode = lightDismissOverlayMode;

Public Property LightDismissOverlayMode As LightDismissOverlayMode

Valeur de propriété

LightDismissOverlayMode

Valeur de l’énumération qui spécifie si la zone à l’extérieur d’une interface utilisateur d’assombrissement de la lumière est assombrie. La valeur par défaut est Auto.

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

L’interface utilisateur temporaire, telle que le volet de suggestion d’un AutoSuggestBox, se ferme lorsque vous cliquez ou appuyez en dehors de celle-ci. C’est ce qu’on appelle light-dismiss. La « superposition » fait référence à la zone située à l’extérieur d’une interface utilisateur avec luminesseur.

Par défaut, la « superposition » est assombrie sur la Xbox et n’est pas assombrie sur d’autres familles d’appareils. Vous pouvez définir LightDismissOverlayMode sur Activé pour que votre application assombrit la zone « superposition » sur toutes les familles d’appareils, ou la définir sur Désactivé pour ne pas assombrir la zone « superposition » sur toutes les familles d’appareils.

Compatibilité des versions

La propriété LightDismissOverlayMode n’est pas disponible avant Windows 10 version 1607. Si le paramètre « version de plateforme minimale » de votre application dans Microsoft Visual Studio est inférieur à la « version introduite » indiquée dans le bloc Configuration requise plus loin dans cette page, vous devez concevoir et tester votre application pour tenir compte de cela. Pour plus d’informations, consultez Code adaptatif de version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions antérieures de Windows 10, ne définissez pas cette propriété en XAML ou ne l’utilisez pas sans effectuer de case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cette propriété avant de la définir.

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