Método MediaCollection.setDeleted

[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 setDeleted mueve el elemento multimedia especificado a la carpeta de elementos eliminados.

Sintaxis

MediaCollection.setDeleted(
  item,
  true
)

Parámetros

item [in]

Objeto multimedia que se va a mover.

true [in]

Especifique siempre este valor.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

Este método no quita archivos del equipo del usuario.

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

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

Ejemplos

En el siguiente ejemplo de JScript se usa MediaCollection. setDeleted para mover un elemento multimedia determinado, almacenado en la variable denominada mediaObject, a la carpeta de elementos eliminados. MediaCollection. El método isDeleted comprueba primero si el elemento ya se ha eliminado. El objeto Player se creó con id. = "Player".

// Test whether the media item is in the deleted items folder.
if (!Player.mediaCollection.isDeleted(mediaObject)){

    // The item is available to be deleted; move it to 
    // the deleted items folder.
    Player.mediaCollection.setDeleted(mediaObject, true);

    // Inform the user that the operation succeeded.
    alert("Item moved to deleted items folder.");}

else
    // Tell the user the operation is unnecessary.
    alert("Item is already deleted!");
}

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0, Reproductor multimedia de Windows versión 7.1 o Reproductor multimedia de Windows para Windows XP. Este método no se admite para Reproductor multimedia de Windows serie 9 o posterior.
Archivo DLL	Wmp.dll

Consulte también

Objeto Media

Objeto MediaCollection

MediaCollection.isDeleted

Settings.mediaAccessRights

Settings.requestMediaAccessRights