Player.uiMode

[Fitur yang terkait dengan halaman ini, Pemutar Media Windows SDK, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih Pemutar Media Windows SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Properti uiMode menentukan atau mengambil nilai yang menunjukkan kontrol mana yang ditampilkan di antarmuka pengguna.

Sintaks

pemain . uiMode

Kemungkinan Nilai

Properti ini adalah String baca/tulis.

Nilai	Deskripsi	Contoh Audio	Contoh Video
Tak terlihat	Pemutar Media Windows disematkan tanpa antarmuka pengguna yang terlihat (kontrol, video, atau jendela visualisasi).	(Tidak ada yang ditampilkan.)	(Tidak ada yang ditampilkan.)
tidak ada	Pemutar Media Windows disematkan tanpa kontrol, dan hanya dengan jendela video atau visualisasi yang ditampilkan.
Mini	Pemutar Media Windows disematkan dengan jendela status, putar/jeda, hentikan, matikan suara, dan kontrol volume yang ditampilkan selain jendela video atau visualisasi.
penuh	Default. Pemutar Media Windows disematkan dengan jendela status, bilah pencarian, putar/jeda, hentikan, matikan suara, berikutnya, sebelumnya, maju cepat, mundur cepat, dan kontrol volume selain jendela video atau visualisasi.
custom	Pemutar Media Windows disematkan dengan antarmuka pengguna kustom. Hanya dapat digunakan dalam program C++.	(Antarmuka pengguna kustom ditampilkan.)	(Antarmuka pengguna kustom ditampilkan.)

Keterangan

Properti ini menentukan tampilan Pemutar Media Windows yang disematkan. Ketika uiMode diatur ke "none", "mini", atau "full", jendela ada untuk tampilan klip video dan visualisasi audio. Jendela ini dapat disembunyikan dalam mode mini atau penuh dengan mengatur atribut tinggi tag OBJECT ke 40, yang diukur dari bawah, dan membiarkan bagian kontrol antarmuka pengguna terlihat. Jika tidak ada antarmuka yang disematkan yang diinginkan, atur atribut lebar dan tinggi ke nol.

Jika uiMode diatur ke "tidak terlihat", tidak ada antarmuka pengguna yang ditampilkan, tetapi ruang masih dicadangkan di halaman seperti yang ditentukan oleh lebar dan tinggi. Ini berguna untuk mempertahankan tata letak halaman ketika uiMode dapat berubah. Selain itu, ruang yang dipesan transparan, sehingga elemen apa pun yang berlapis di belakang kontrol akan terlihat.

Jika uiMode diatur ke "penuh" atau "mini", Pemutar Media Windows menampilkan kontrol transportasi dalam mode layar penuh. Jika uiMode diatur ke "tidak ada", tidak ada kontrol yang ditampilkan dalam mode layar penuh.

Jika jendela terlihat dan konten audio sedang diputar, visualisasi yang ditampilkan akan menjadi yang terakhir digunakan dalam Pemutar Media Windows.

Jika uiMode diatur ke "kustom" dalam program C++ yang mengimplementasikan IWMPRemoteMediaServices, file kulit yang ditunjukkan oleh IWMPRemoteMediaServices::GetCustomUIMode ditampilkan.

Selama pemutaran layar penuh, Pemutar Media Windows menyembunyikan kursor mouse saat enableContextMenu sama dengan false dan uiMode sama dengan "none".

Contoh

Contoh berikut membuat elemen HTML SELECT yang memungkinkan pengguna mengubah antarmuka pengguna untuk objek Pemutar yang disematkan. Objek Pemutar dibuat dengan ID = "Pemutar".

<!-- Create an HTML SELECT element. -->
<SELECT  ID = UI  LANGUAGE="JScript"

         /* Specify the UI mode the user selects. */
         onChange = "Player.uiMode = UI.value">

/* These are the four UI mode options. */
<OPTION VALUE="invisible">Invisible
<OPTION VALUE="none">No Controls
<OPTION VALUE="mini">Mini Player
<OPTION VALUE="full">Full Player
</SELECT>

Pemutar Media Windows 10 Mobile: Properti ini hanya menerima atau mengembalikan nilai "none" atau "full". Pada perangkat Smartphone, hanya status pemutaran dan penghitung yang ditampilkan saat uiMode diatur ke "penuh".

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows versi 7.0 atau yang lebih baru. Pemutar Media Windows Seri 9 atau yang lebih baru untuk "tidak terlihat" atau "kustom".
DLL	Wmp.dll

Lihat juga

Antarmuka IWMPRemoteMediaServices

IWMPRemoteMediaServices::GetCustomUIMode

Objek Pemutar