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

列舉值，指定是否播放音效的控件喜好設定。 預設值為 Auto。

備註

設定 ElementSoundMode 屬性以覆寫特定控件的全域 ElementSoundPlayer 設定。

如需使用此屬性的詳細資訊，請參閱 音效設計指引。

版本相容性

在 Windows 10 1607 版之前，無法使用 ElementSoundMode 屬性。 如果您的 App 在 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
• 音效設計指引