Share via


Media.name

[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.

La propiedad name especifica o recupera el nombre del elemento multimedia.

Sintaxis

jugador. currentMedia. Nombre

Valores posibles

Esta propiedad es una cadena de lectura y escritura que contiene el nombre del elemento multimedia.

Observaciones

Para recuperar el valor de esta propiedad, se requiere acceso de lectura a la biblioteca. Para especificar el valor de esta propiedad, se requiere acceso completo a la biblioteca. Para obtener más información, consulte Acceso a la biblioteca.

Antes de usar este método para especificar el nombre de un elemento multimedia, use isReadOnlyItem para determinar si se puede establecer el nombre.

Reproductor multimedia de Windows 10 Mobile: esta propiedad es de solo lectura.

Ejemplos

En el ejemplo siguiente de JScript se usa Media. name para cambiar el nombre del elemento multimedia actual. Un elemento de entrada TEXT HTML denominado NameText permite al usuario escribir una cadena de texto para el nuevo nombre. El objeto Player se creó con id. = "Player".

<!<entity type="mdash"/>-Create an HTML BUTTON element to execute the name change. -->
<INPUT type = "BUTTON"  id = "NewName"  name = "NewName"  value = "Change Name" 
    onClick = "

        /* Store the current media item. */
        var cm = Player.currentMedia;

        /* Change the name. */
        cm.name = NameText.value;
">

Requisitos

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

Consulte también

Media (objeto)

Settings.mediaAccessRights

Settings.requestMediaAccessRights