Método Media.setItemInfo

[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 setItemInfo establece el valor del atributo especificado para el elemento multimedia actual.

Sintaxis

Media.setItemInfo(
  attribute,
  value
)

Parámetros

atributo [in]

Cadena que contiene el nombre del atributo. Para obtener información sobre los atributos admitidos por Reproductor multimedia de Windows, consulte la referencia de atributos de Reproductor multimedia de Windows.

value [in]

Cadena que contiene el nuevo valor.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

La propiedad attributeCount contiene el número de atributos disponibles para un objeto Media determinado. A continuación, los números de índice se pueden usar con el método getAttributeName para determinar los nombres de los atributos integrados que se pueden usar con este método.

Antes de usar este método, use el método isReadOnlyItem para determinar si se puede establecer un atributo determinado.

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

Note

Si inserta el control Reproductor multimedia de Windows en la aplicación, los atributos de archivo que cambie no se escribirán en el archivo multimedia digital hasta que el usuario ejecute Reproductor multimedia de Windows. Si usa el control en una aplicación remota escrita en C++, los atributos de archivo que cambie se escribirán en el archivo multimedia digital poco después de realizar los cambios. En cualquier caso, los cambios están disponibles inmediatamente para el código a través de la biblioteca.

Reproductor multimedia de Windows 10 Mobile: este método no se implementa.

Ejemplos

En el ejemplo siguiente de JScript se usa Media. setItemInfo para cambiar el valor del atributo Genre para el elemento multimedia actual. Un elemento de entrada TEXT HTML denominado genText permite al usuario escribir una cadena de texto, que luego se usa para cambiar la información del atributo. El objeto Player se creó con id. = "Player".

<!-- Create the button element. -->
<INPUT type = "BUTTON"  id = "NEWGEN"  name = "NEWGEN"  value = "Change Genre" 
onClick = "
    /* Store the current media item. */
    var cm = Player.currentMedia;

    /* Get the user input from the text box. */
    var atValue = genText.value;

    /* Test for read-only status of the attribute. */
    if(cm.isReadOnlyItem('Genre') == false){

        /* Change the attribute value. */
        cm.setItemInfo('Genre' ,atValue);
    } 
">

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Media (objeto)

Media.getItemInfo

Media.isReadOnlyItem

Settings.mediaAccessRights

Settings.requestMediaAccessRights