Método MediaCollection.getAttributeStringCollection
[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
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 .
Observaciones
Para usar este método, se requiere acceso de lectura a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.
Para obtener información sobre los atributos admitidos por Reproductor multimedia de Windows, vea la sección Referencia de atributos.
Ejemplos
En el ejemplo siguiente de 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 de medios. 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 |
|
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte:Enviar y ver comentarios de