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
Wmp.dll

Consulte también

Objeto MediaCollection

Settings.mediaAccessRights

Settings.requestMediaAccessRights

StringCollection (objeto)