Méthode MediaCollection.setDeleted

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode setDeleted déplace l’élément multimédia spécifié vers le dossier des éléments supprimés.

Syntaxe

MediaCollection.setDeleted(
  item,
  true
)

Paramètres

item [in]

Objet multimédia déplacé.

true [in]

Spécifiez toujours cette valeur.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Cette méthode ne supprime pas les fichiers de l’ordinateur de l’utilisateur.

Pour utiliser cette méthode, un accès complet à la bibliothèque est requis. Pour plus d’informations, consultez Accès à la bibliothèque.

Lecteur multimédia Windows 10 Mobile : cette méthode n’est pas prise en charge.

Exemples

L’exemple JScript suivant utilise MediaCollection. setDeleted pour déplacer un élément multimédia particulier, stocké dans la variable nommée mediaObject, vers le dossier des éléments supprimés. MediaCollection. La méthode isDeleted teste d’abord si l’élément a déjà été supprimé. L’objet Player a été créé avec 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!");
}

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0, Lecteur multimédia Windows version 7.1 ou Lecteur multimédia Windows pour Windows XP. Cette méthode n’est pas prise en charge pour Lecteur multimédia Windows série 9 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Objet Media

Objet MediaCollection

MediaCollection.isDeleted

Settings.mediaAccessRights

Settings.requestMediaAccessRights