Método MediaCollection.getAttributeStringCollection
El método getAttributeStringCollection recupera un objeto StringCollection que representa el conjunto de todos los valores de un atributo especificado dentro de un tipo de medio especificado.
Sintaxis
retVal = MediaCollection.getAttributeStringCollection(
attribute,
mediaType
)
Parámetros
-
atributo [in]
-
Cadena que especifica el atributo .
-
mediaType [in]
-
Cadena que representa el tipo de medio. Contiene uno de los siguientes valores: "Audio", "Video", "Playlist" o "Other".
Valor devuelto
Este método devuelve un objeto StringCollection .
Comentarios
Para usar este método, se requiere acceso de lectura a la biblioteca. Para obtener más información, vea Acceso a bibliotecas.
Para obtener información sobre los atributos admitidos por Reproductor multimedia de Windows, consulte la sección Referencia de atributos.
Ejemplos
En el ejemplo siguiente JScript se usa MediaCollection. getAttributeStringCollection para mostrar una lista de valores que corresponden a un atributo determinado para los elementos de audio de la colección multimedia. Un elemento SELECT HTML, creado con ID = "Attribute", permite al usuario seleccionar un atributo, como Artist, Genre o Album. Un elemento TEXTAREA HTML, creado con ID = "AttributeVals", muestra el resultado. El objeto Player se creó 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";
}
Requisitos
| Requisito | Value |
|---|---|
| Versión |
Reproductor multimedia de Windows versión 7.0 o posterior. |
| Archivo DLL |
|