Control.ElementSoundMode Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit une valeur qui spécifie la préférence d’un contrôle pour savoir si les sons sont lus.

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

ElementSoundMode ElementSoundMode();

void ElementSoundMode(ElementSoundMode value);

public ElementSoundMode ElementSoundMode { get; set; }

var elementSoundMode = control.elementSoundMode;
control.elementSoundMode = elementSoundMode;

Public Property ElementSoundMode As ElementSoundMode

<control ElementSoundMode="elementSoundModeMemberName"/>

Valeur de propriété

ElementSoundMode

Valeur de l’énumération qui spécifie la préférence d’un contrôle pour savoir si les sons sont lus. 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

Définissez la propriété ElementSoundMode pour remplacer le paramètre Global ElementSoundPlayer pour un contrôle spécifique.

Pour plus d’informations sur l’utilisation de cette propriété, consultez Audio dans les applications UWP.

Compatibilité des versions

La propriété ElementSoundMode 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.Control", "ElementSoundMode"))
    {
        button1.ElementSoundMode = ElementSoundMode.Off;
    }
}

Voir aussi

• ElementSoundPlayer
• Son dans les applications UWP