Metode External.cancelNavigate

[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.]

Catatan

Topik ini menjelaskan fungsionalitas yang dirancang untuk digunakan oleh toko online. Penggunaan fungsionalitas ini di luar konteks toko online tidak didukung.

Metode cancelNavigate menginformasikan Pemutar Media Windows bahwa metode tersebut tidak boleh menampilkan halaman penemuan baru meskipun tampilan telah berubah di Pemutar.

Sintaks

External.cancelNavigate()

Parameter

Metode ini tidak memiliki parameter.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Saat tampilan berubah di Pemutar Media Windows, Pemutar memanggil plug-in toko online untuk menentukan halaman penemuan mana yang akan ditampilkan berikutnya. Namun, dalam beberapa kasus, toko online mungkin ingin Pemutar terus menampilkan halaman penemuan yang ada. Proses berikut menentukan apakah Pemutar menampilkan halaman penemuan baru:

1. Tindakan oleh pengguna, baik di antarmuka pengguna Pemutar atau di halaman penemuan, meminta Pemutar mengubah tampilannya.
2. Pemutar memanggil metode GetTemplate plug-in untuk menentukan halaman penemuan mana yang akan ditampilkan berikutnya. Pemutar menyimpan URL halaman penemuan baru tetapi saat ini tidak menampilkan halaman penemuan baru.
3. Pemutar menaikkan peristiwa OnViewChange .
4. Jika penanganan aktivitas OnViewChange pada halaman penemuan memanggil cancelNavigate, Pemutar tidak menampilkan halaman penemuan baru (ditentukan di langkah 2). Sebaliknya, ia terus menampilkan halaman penemuan yang ada. Jika penanganan aktivitas OnViewChange tidak memanggil cancelNavigate, Pemutar memang menampilkan halaman penemuan baru.

Misalnya, Pemutar saat ini menampilkan tampilan album dengan trek tertentu yang dipilih. Asumsikan juga bahwa halaman penemuan saat ini adalah halaman yang mewakili seluruh album. Jika pengguna mengklik trek yang berbeda dari album yang sama, tampilan Pemutar sedikit berubah untuk menunjukkan bahwa trek baru dipilih. Tetapi tidak perlu menampilkan halaman penemuan baru. Halaman penemuan yang mewakili seluruh album masih merupakan halaman yang sesuai untuk ditampilkan oleh Pemutar.

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows 11.
DLL	Wmp.dll

Lihat juga

Objek Eksternal untuk Toko Online Tipe 1

External.changeViewOnlineList

External.OnViewChange