Control.ElementSoundMode Properti

Definisi

Mendapatkan atau menetapkan nilai yang menentukan preferensi kontrol untuk apakah suara diputar.

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

Nilai Properti

Nilai enumerasi yang menentukan preferensi kontrol untuk apakah suara diputar. Defaultnya adalah Otomatis.

Persyaratan Windows

Rangkaian perangkat
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)

Keterangan

Atur properti ElementSoundMode untuk mengambil alih pengaturan ElementSoundPlayer global untuk kontrol tertentu.

Untuk informasi selengkapnya tentang menggunakan properti ini, lihat Suara di aplikasi UWP.

Kompatibilitas versi

Properti ElementSoundMode tidak tersedia sebelum Windows 10, versi 1607. Jika pengaturan 'versi platform minimum' aplikasi Anda di Microsoft Visual Studio kurang dari 'versi yang diperkenalkan' yang ditunjukkan di blok Persyaratan nanti di halaman ini, Anda harus merancang dan menguji aplikasi Anda untuk mempertanyakan hal ini. Untuk informasi selengkapnya, lihat Kode adaptif versi.

Untuk menghindari pengecualian saat aplikasi Anda berjalan pada versi Windows 10 sebelumnya, jangan atur properti ini di XAML atau gunakan tanpa melakukan pemeriksaan runtime. Contoh ini menunjukkan cara menggunakan kelas ApiInformation untuk memeriksa keberadaan properti ini sebelum Anda mengaturnya.

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

Berlaku untuk

Lihat juga