IWMPMediaCollection::remove, méthode

[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 remove méthode supprime un élément spécifié de la collection de supports.

Syntaxe

public void remove(
  IWMPMedia pItem,
  System.Boolean varfDeleteFile
);

Public Sub remove( _
  ByVal pItem As IWMPMedia, _
  ByVal varfDeleteFile As System.Boolean _
)
Implements IWMPMediaCollection.remove

Paramètres

pItem [in]

Interface WMPLib.IWMPMedia qui identifie l’élément à supprimer.

varfDeleteFile [in]

Valeur System.Boolean qui spécifie si la méthode doit supprimer l’élément spécifié de la bibliothèque.

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.

Avant d’appeler cette méthode, vous devez disposer d’un accès en lecture à la bibliothèque. Pour plus d’informations, consultez Accès à la bibliothèque.

Exemples

L’exemple suivant, après avoir invité l’utilisateur, supprime définitivement le premier élément multimédia de la collection de médias à l’aide removede . L’objet AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée player.

// Get an interface to the first item from the media collection. 
WMPLib.IWMPMedia3 media = (WMPLib.IWMPMedia3)player.mediaCollection.getAll().get_Item(0);

// Store the name of the retrieved media item.
string mediaName = media.name;

// Prepare a message, a caption and buttons for the user prompt.
string message = ("OK to permanently delete " + mediaName + "?");
string caption = "Confirm deletion";
System.Windows.Forms.MessageBoxButtons buttons = System.Windows.Forms.MessageBoxButtons.OKCancel;

// Prompt the user for permission to delete the object.
System.Windows.Forms.DialogResult result = System.Windows.Forms.MessageBox.Show(message, caption, buttons);

// Check the user response.
if (result == System.Windows.Forms.DialogResult.OK)
{
    // Permanently delete the item.
    player.mediaCollection.remove(media, true);

    // Report that the item was deleted.
    System.Windows.Forms.MessageBox.Show("Deleted item " + mediaName);
}

' Get an interface to the first item from the media collection. 
Dim media As WMPLib.IWMPMedia3 = player.mediaCollection.getAll().Item(0)

' Store the name of the retrieved media item.
Dim mediaName As String = media.name

' Prepare a message, a caption and buttons for the user prompt.
Dim message As String = ("OK to permanently delete " + mediaName + "?")
Dim caption As String = "Confirm deletion"
Dim buttons As System.Windows.Forms.MessageBoxButtons = System.Windows.Forms.MessageBoxButtons.OKCancel

' Prompt the user for permission to delete the object.
Dim result As System.Windows.Forms.DialogResult = System.Windows.Forms.MessageBox.Show(message, caption, buttons)

' Check the user response.
If (result = System.Windows.Forms.DialogResult.OK) Then

    ' Permanently delete the item.
    player.mediaCollection.remove(media, True)

    ' Report that the item was deleted.
    System.Windows.Forms.MessageBox.Show("Deleted item " + mediaName)

End If

Configuration requise

Condition requise	Valeur
Version	série Lecteur multimédia Windows 9 ou ultérieure
Espace de noms	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

IWMPMedia Interface (VB et C#)

IWMPMediaCollection, interface (VB et C#)

IWMPMediaCollection.add (VB et C#)