Metodo MediaCollection.getAttributeStringCollection

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getAttributeStringCollection recupera un oggetto StringCollection che rappresenta il set di tutti i valori per un attributo specificato all'interno di un tipo di supporto specificato.

Sintassi

retVal = MediaCollection.getAttributeStringCollection(
  attribute,
  mediaType
)

Parametri

attributo [in]

Stringa che specifica l'attributo.

mediaType [in]

Stringa che rappresenta il tipo di supporto. Contiene uno dei valori seguenti: "Audio", "Video", "Playlist" o "Other".

Valore restituito

Questo metodo restituisce un oggetto StringCollection .

Commenti

Per usare questo metodo, è necessario l'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Per informazioni sugli attributi supportati da Lettore multimediale Windows, vedere la sezione Riferimento agli attributi.

Esempio

L'esempio JScript seguente usa MediaCollection. getAttributeStringCollection per visualizzare un elenco di valori che corrispondono a un attributo specifico per gli elementi audio nella raccolta multimediale. Un elemento SELECT HTML, creato con ID = "Attribute", consente all'utente di selezionare un attributo, ad esempio Artist, Genre o Album. Un elemento HTML TEXTAREA, creato con ID = "AttributeVals", visualizza il risultato. L'oggetto Player è stato creato con ID = "Player".

// 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";
}

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Oggetto MediaCollection

Settings.mediaAccessRights

Settings.requestMediaAccessRights

Oggetto StringCollection