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 設定をオーバーライドします。

このプロパティの使用方法の詳細については、「 サウンドデザインガイダンス」を参照してください。

バージョンの互換性

ElementSoundMode プロパティは、バージョン 1607 Windows 10より前は使用できません。 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
• サウンド 設計ガイダンス