Méthode MediaCollection.remove

[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 remove supprime un élément de la collection multimédia.

Syntaxe

MediaCollection.remove(
  item,
  delete
)

Paramètres

item [in]

Objet multimédia à supprimer.

delete [in]

Boolean indiquant s’il faut supprimer l’élément.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Cette méthode supprime un élément de la bibliothèque. 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.

Exemples

L’exemple JScript suivant, après avoir invité l’utilisateur, supprime définitivement le premier élément multimédia de la collection multimédia à l’aide de MediaCollection. supprimer. L’objet Player a été créé avec l’ID = « Player ».

// Retrieve the first item from the media collection.
var mediaObject = Player.mediaCollection.getAll().item(0);

// Store the name of the retrieved object.
var mediaName = mediaObject.name;

// Prompt the user for permission to delete the object.
var answer = confirm("OK to permanently delete " + mediaName + "?");

// Check the user response.
if (answer){

    // Permanently delete the item.
    Player.mediaCollection.remove(mediaObject, true);

    // Report that the item was deleted.
    alert("Deleted item " + mediaName);
}

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Objet Media

Objet MediaCollection

MediaCollection.add

Settings.mediaAccessRights

Settings.requestMediaAccessRights