Метод MediaCollection.remove

  • Статья

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

Метод remove удаляет элемент из коллекции мультимедиа.

Синтаксис

MediaCollection.remove(
  item,
  delete
)

Параметры

item [in]

Удаляемый объект мультимедиа.

delete [in]

Логическое значение, указывающее, следует ли удалить элемент.

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

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

Комментарии

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

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

Примеры

Следующий пример JScript после запроса пользователю окончательно удаляет первый элемент мультимедиа в коллекции мультимедиа с помощью MediaCollection. удалить. Объект Player был создан с идентификатором " 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);
}

Требования

Требование Значение
Версия
 Медиаплеер Windows версии 7.0 или более поздней.
DLL
Wmp.dll

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

Объект media

Объект MediaCollection

MediaCollection.add

Settings.mediaAccessRights

Settings.requestMediaAccessRights