Поделиться через


Control.ElementSoundMode Свойство

Определение

Возвращает или задает значение, указывающее предпочтительное значение элемента управления для воспроизведения звуков.

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

Значение свойства

Значение перечисления, указывающее предпочтительность элемента управления для воспроизведения звуков. Значение по умолчанию — Auto.

Требования к Windows

Семейство устройств
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v3.0)

Комментарии

Задайте свойство ElementSoundMode, чтобы переопределить глобальный параметр ElementSoundPlayer для определенного элемента управления.

Дополнительные сведения об использовании этого свойства см. в разделе Звук в приложениях UWP.

Совместимость версий

Свойство ElementSoundMode недоступно до Windows 10 версии 1607. Если параметр "минимальная версия платформы" вашего приложения в Microsoft Visual Studio меньше , чем "представленная версия", показанная в блоке "Требования" далее на этой странице, необходимо разработать и протестировать приложение, чтобы учесть это. Дополнительные сведения см. в разделе Код с адаптивной версией.

Чтобы избежать исключений при выполнении приложения в предыдущих версиях Windows 10, не устанавливайте это свойство в XAML и не используйте его без выполнения проверка среды выполнения. В этом примере показано, как использовать класс ApiInformation для проверка наличия этого свойства перед его настройкой.

 private void MainPage_Loaded(object sender, RoutedEventArgs e)
 {
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "ElementSoundMode"))
    {
        button1.ElementSoundMode = ElementSoundMode.Off;
    }
}

Применяется к

См. также раздел