Control.ElementSoundMode Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que especifica a preferência de um controle para se os sons são reproduzidos.

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

Valor da propriedade

ElementSoundMode

Um valor da enumeração que especifica a preferência de um controle para se os sons são reproduzidos. 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

Defina a propriedade ElementSoundMode para substituir a configuração global ElementSoundPlayer para um controle específico.

Para obter mais informações sobre como usar essa propriedade, consulte Som em aplicativos UWP.

Compatibilidade de versões

A propriedade ElementSoundMode 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 que a "versão introduzida" mostrada no bloco Requisitos posteriormente 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.Control", "ElementSoundMode"))
    {
        button1.ElementSoundMode = ElementSoundMode.Off;
    }
}

Confira também

• ElementSoundPlayer
• Som em aplicativos UWP