Событие Player.CurrentPlaylistChange

Статья
06/21/2023

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

Событие CurrentPlaylistChange возникает, когда что-то меняется в текущем списке воспроизведения.

Синтаксис

Player.CurrentPlaylistChange(
  change
)

Параметры

change: Число (long), указывающее, какой тип изменения произошло в списке воспроизведения. См. раздел Проигрыватель. Событие PlaylistChange для таблицы возможных значений.

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

Это событие не возвращает значение.

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

Значение параметров события задается Медиаплеер Windows и может быть доступно или передано методу в импортированном файле JScript, используя заданное имя параметра. Имя этого параметра должно быть введено точно так, как показано ниже, включая прописные буквы.

Примеры

В следующем примере JScript текст в элементе DIV HTML с именем PlItems обновляется для отображения имен элементов мультимедиа в текущем списке воспроизведения. Объект Player был создан с идентификатором " Player".

<!-- Create an event handler for current playlist change. -->
<SCRIPT FOR = "Player" EVENT = "currentPlaylistChange(change)">
   switch (change){
      // Only update for move, delete, insert, and append events.
      case 3, 4, 5, 6:

         // Clear the contents of the DIV.
         PlItems.innerHTML = "";

         // Loop through the playlist and display each item name.
         for (var i = 0; i < Player.currentPlaylist.count; i++){
            PlItems.innerHTML += Player.currentPlaylist.item(i).name;
            PlItems.innerHTML += "<br>";
         }
         break;
      
      default:
   } 
</SCRIPT>

Требования

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

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

Объект Player
Player.currentPlaylist
Player.PlaylistChange