Metode Media.isReadOnlyItem

Artikel
06/21/2023

[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 isReadOnlyItem mengembalikan nilai yang menunjukkan apakah atribut item media yang ditentukan dapat diedit.

Sintaks

bRetVal = Media.isReadOnlyItem(
  attribute
)

Parameter

atribut [in]: String yang menunjukkan nama atribut yang akan diuji. Untuk informasi tentang atribut yang didukung oleh Pemutar Media Windows, lihat Referensi Atribut Pemutar Media Windows..

Mengembalikan nilai

Metode ini mengembalikan Boolean.

Keterangan

Jika atribut bersifat baca-saja, maka atribut tidak dapat diatur dengan metode setItemInfo . Perhatikan bahwa metode ini dapat mengembalikan nilai yang berbeda untuk atribut tertentu saat digunakan dengan versi Pemutar Media Windows yang berbeda.

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

Pemutar Media Windows 10 Mobile: Properti ini selalu mengembalikan true.

Contoh

Contoh JScript berikut menggunakan Media. isReadOnlyItem untuk mengisi elemen HTML TEXTAREA bernama rwText dengan informasi tentang item media saat ini. Kode menghasilkan setiap atribut item media saat ini, bersama dengan teks yang menunjukkan apakah atribut bersifat baca-saja atau baca/tulis. Objek Pemutar dibuat dengan ID = "Pemutar".

// Store the current media item object.
var cm = Player.currentMedia;

// Create a variable to hold each attribute name.
var atName;

// Loop through the attribute list.
for(var i = 0; i < cm.attributeCount; i++){

   // Get the attribute name.
   atName = cm.getAttributeName(i);

   // Test whether the attribute is read-only.
   var test = ((cm.isReadOnlyItem(atName))?"Read-Only":"Read/Write");

// Print the attribute information to the text area.
   rwText.value += atName + " is " + test;
   rwText.value += "\n";
}

Persyaratan

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

Lihat juga

Objek Media
Media.setItemInfo
Settings.mediaAccessRights
Settings.requestMediaAccessRights