Metode MediaCollection.getAttributeStringCollection

[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 getAttributeStringCollection mengambil objek StringCollection yang mewakili kumpulan semua nilai untuk atribut tertentu dalam jenis media tertentu.

Sintaks

retVal = MediaCollection.getAttributeStringCollection(
  attribute,
  mediaType
)

Parameter

atribut [in]

String yang menentukan atribut .

mediaType [in]

String yang mewakili jenis media. Berisi salah satu nilai berikut: "Audio", "Video", "Daftar Putar", atau "Lainnya".

Mengembalikan nilai

Metode ini mengembalikan objek StringCollection .

Keterangan

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

Untuk informasi tentang atribut yang didukung oleh Pemutar Media Windows, lihat bagian Referensi Atribut.

Contoh

Contoh JScript berikut menggunakan MediaCollection. getAttributeStringCollection untuk menampilkan daftar nilai yang sesuai dengan atribut tertentu untuk item audio dalam koleksi media. Elemen HTML SELECT, yang dibuat dengan ID = "Attribute", memungkinkan pengguna untuk memilih atribut, seperti Artis, Genre, atau Album. Elemen TEXTAREA HTML, yang dibuat dengan ID = "AttributeVals", menampilkan hasilnya. Objek Pemutar dibuat dengan ID = "Pemutar".

// Clear the text in the display area.
AttributeVals.value = "";

// Store the mediaCollection object.
var library = Player.mediaCollection;

// Get the string collection for the attribute type the user selects.
var all = library.getAttributeStringCollection(Attribute.value, "Audio");

// Loop through the string collection.
for (i = 0; i < all.count; i++){

    // Display the items one line at a time.
    AttributeVals.value += all.item(i);
    AttributeVals.value += "\n";
}

Persyaratan

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

Lihat juga

Objek MediaCollection

Settings.mediaAccessRights

Settings.requestMediaAccessRights

Objek StringCollection