Control.ElementSoundMode Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtenha 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.

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 Diretrizes de design de som.

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 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 uma marcar de runtime. 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
• Diretrizes de design de som