IWMPMediaCollection：：setDeleted 方法

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 setDeleted 将指定的媒体项移动到已删除邮件文件夹。

语法

public void setDeleted(
  IWMPMedia pItem,
  System.Boolean varfIsDeleted
);

Public Sub setDeleted( _
  ByVal pItem As IWMPMedia, _
  ByVal varfIsDeleted As System.Boolean _
)
Implements IWMPMediaCollection.setDeleted

parameters

pItem [in]

要移动的项的 WMPLib.IWMPMedia 接口。

varfIsDeleted [in]

一个 System.Boolean 值，该值指定是否应将项目移动到已删除邮件文件夹。 此值必须始终 为 true。

返回值

此方法不返回值。

备注

此方法不会从用户的计算机中删除文件，只会将它们移动到已删除的项目文件夹。

在调用此方法之前，必须具有对库的读取访问权限。 有关详细信息，请参阅 库访问。

示例

以下示例使用 setDeleted 将特定媒体项移动到已删除邮件文件夹。 isDeleted 方法首先测试是否已删除该项。 AxWMPLib.AxWindowsMediaPlayer 对象由名为 player 的变量表示。

// Test whether the media item has already been deleted.
if (!player.mediaCollection.isDeleted(media))
{
    // The item is available to be deleted; move it to the deleted items folder.
    player.mediaCollection.setDeleted(media, true);

    // Inform the user that the operation succeeded.
    System.Windows.Forms.MessageBox.Show("Item moved to deleted items folder.");
}
else
{
    // Tell the user the operation is unnecessary.
    System.Windows.Forms.MessageBox.Show("Item is already deleted!");
}

' Test whether the media item has already been deleted.
If (Not player.mediaCollection.isDeleted(media)) Then

    ' The item is available to be deleted move it to the deleted items folder.
    player.mediaCollection.setDeleted(media, True)

    ' Inform the user that the operation succeeded.
    System.Windows.Forms.MessageBox.Show("Item moved to deleted items folder.")

Else

    ' Tell the user the operation is unnecessary.
    System.Windows.Forms.MessageBox.Show("Item is already deleted!")

End If

要求

要求	值
版本	Windows 媒体播放器 9 系列或更高版本
命名空间	WMPLib
程序集	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另请参阅

IWMPMedia 接口 (VB 和 C#)

IWMPMediaCollection 接口 (VB 和 C#)