Método Media.setItemInfo

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.

Nota

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 de JScript siguiente 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 después 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

Configuración.mediaAccessRights

Configuración.requestMediaAccessRights