Control.ElementSoundMode 属性

定义

命名空间:

Microsoft.UI.Xaml.Controls

获取或设置一个值，该值指定控件是否播放声音的首选项。

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

属性值

ElementSoundMode

枚举的一个值，该值指定控件是否播放声音的首选项。 默认值为 “自动”。

注解

设置 ElementSoundMode 属性以替代特定控件的全局 ElementSoundPlayer 设置。

有关使用此属性的详细信息，请参阅 声音设计指南。

版本兼容性

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;
    }
}

另请参阅

• ElementSoundPlayer
• 声音设计指南