MediaCollection.remove-Methode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die remove-Methode entfernt ein Element aus der Medienauflistung.

Syntax

MediaCollection.remove(
  item,
  delete
)

Parameter

Item [in]

Zu entfernende Medienobjekt.

löschen [in]

Boolesch , der angibt, ob das Element entfernt werden soll.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Diese Methode löscht ein Element aus der Bibliothek. Diese Methode löscht keine Dateien vom Computer des Benutzers.

Um diese Methode zu verwenden, ist voller Zugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.

Beispiele

Im folgenden JScript-Beispiel wird das erste Medienelement in der Mediensammlung mithilfe von MediaCollection nach Aufforderung des Benutzers endgültig gelöscht. entfernen. Das Player-Objekt wurde mit der ID = "Player" erstellt.

// 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);
}

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

Medienobjekt

MediaCollection-Objekt

MediaCollection.add

Settings.mediaAccessRights

Settings.requestMediaAccessRights