Metode Media.setItemInfo

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

Metode setItemInfo menetapkan nilai atribut yang ditentukan untuk item media saat ini.

Sintaks

Media.setItemInfo(
  attribute,
  value
)

Parameter

atribut [in]

String yang berisi nama atribut. Untuk informasi tentang atribut yang didukung oleh Pemutar Media Windows, lihat Referensi Atribut Pemutar Media Windows.

value [in]

String yang berisi nilai baru.

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Properti attributeCount berisi jumlah atribut yang tersedia untuk objek Media tertentu. Nomor indeks kemudian dapat digunakan dengan metode getAttributeName untuk menentukan nama atribut bawaan yang dapat digunakan dengan metode ini.

Sebelum menggunakan metode ini, gunakan metode isReadOnlyItem untuk menentukan apakah atribut tertentu dapat diatur.

Untuk menggunakan metode ini, diperlukan akses penuh ke pustaka. Untuk informasi selengkapnya, lihat Akses Pustaka.

Catatan

Jika Anda menyematkan kontrol Pemutar Media Windows di aplikasi Anda, atribut file yang Anda ubah tidak akan ditulis ke file media digital hingga pengguna berjalan Pemutar Media Windows. Jika Anda menggunakan kontrol dalam aplikasi jarak jauh yang ditulis dalam C++, atribut file yang Anda ubah akan ditulis ke file media digital tak lama setelah Anda membuat perubahan. Dalam kedua kasus, perubahan segera tersedia untuk kode Anda melalui pustaka.

Pemutar Media Windows 10 Mobile: Metode ini tidak diimplementasikan.

Contoh

Contoh JScript berikut menggunakan Media. setItemInfo untuk mengubah nilai atribut Genre untuk item media saat ini. Elemen input TEKS HTML bernama genText memungkinkan pengguna memasukkan string teks, yang kemudian digunakan untuk mengubah informasi atribut. Objek Pemutar dibuat dengan ID = "Pemutar".

<!-- Create the button element. -->
<INPUT type = "BUTTON"  id = "NEWGEN"  name = "NEWGEN"  value = "Change Genre" 
onClick = "
    /* Store the current media item. */
    var cm = Player.currentMedia;

    /* Get the user input from the text box. */
    var atValue = genText.value;

    /* Test for read-only status of the attribute. */
    if(cm.isReadOnlyItem('Genre') == false){

        /* Change the attribute value. */
        cm.setItemInfo('Genre' ,atValue);
    } 
">

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows versi 7.0 atau yang lebih baru.
DLL	Wmp.dll

Lihat juga

Objek Media

Media.getItemInfo

Media.isReadOnlyItem

Settings.mediaAccessRights

Settings.requestMediaAccessRights