Метод MediaCollection.setDeleted

[Функция, связанная с этой страницей, Медиаплеер Windows sdk, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод setDeleted перемещает указанный элемент мультимедиа в папку удаленных элементов.

Синтаксис

MediaCollection.setDeleted(
  item,
  true
)

Параметры

item [in]

Перемещаемый объект мультимедиа .

true [in]

Всегда указывайте это значение.

Возвращаемое значение

Этот метод не возвращает значение.

Комментарии

Этот метод не удаляет файлы с компьютера пользователя.

Для использования этого метода требуется полный доступ к библиотеке. Дополнительные сведения см. в разделе Доступ к библиотеке.

Медиаплеер Windows 10 Mobile: этот метод не поддерживается.

Примеры

В следующем примере JScript используется MediaCollection. setDeleted для перемещения определенного элемента мультимедиа, хранящегося в переменной с именем mediaObject, в папку удаленных элементов. MediaCollection. Метод isDeleted сначала проверяет, был ли элемент уже удален. Объект Player был создан с идентификатором " 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!");
}

Требования

Требование Значение
Версия
Медиаплеер Windows версии 7.0, Медиаплеер Windows версии 7.1 или Медиаплеер Windows для Windows XP. Этот метод не поддерживается для Медиаплеер Windows серии 9 и более поздних версий.
DLL
Wmp.dll

См. также раздел

Объект media

Объект MediaCollection

MediaCollection.isDeleted

Settings.mediaAccessRights

Settings.requestMediaAccessRights