Método StringCollection.getItemInfoByType

Artículo
06/21/2023

[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 getItemInfoByType recupera el valor correspondiente al índice StringCollection , el nombre, el idioma y el índice de atributo especificados.

Sintaxis

retVal = StringCollection.getItemInfoByType(
  index,
  name,
  language,
  attributeIndex
)

Parámetros

index [in]: Number (long) que especifica el índice de base cero del elemento StringCollection del que se va a obtener el atributo.
name [in]: Cadena que contiene el nombre del atributo.
idioma [in]: Cadena que contiene el idioma. Si el valor se establece en null o en la cadena vacía ("") se usa la cadena de configuración regional actual. De lo contrario, el valor debe ser una cadena de idioma RFC 1766 válida, como "en-us".
attributeIndex [in]: Número (long) que contiene el índice de base cero del valor que se va a recuperar del atributo.

Valor devuelto

Este método devuelve un objeto Number, String, MetadataPicture o metadataText como se indica en la tabla siguiente.

Atributo	Valor devuelto
SyncState	Número (unsigned long)
WM/Lyrics_Synchronised	MetadataText ( objeto)
WM/Picture	MetadataPicture (objeto)
WM/UserWebURL	MetadataText ( objeto)
Resto de atributos	String

Para los atributos cuyo valor subyacente es Boolean, este método devuelve la cadena "true" o "false".

Observaciones

Este método admite atributos con varios valores y atributos con valores complejos. El método getItemInfo no admite atributos con varios valores o complejos.

Para usar este método, se requiere acceso de lectura a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows 11.
Archivo DLL	Wmp.dll

Consulte también

MetadataPicture (objeto)
MetadataText (objeto)
StringCollection.getItemInfo
StringCollection (objeto)

Share via