Control.ElementSoundMode Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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;
}
}