Метод PlaylistCollection.getByName

Статья
06/21/2023

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

Метод getByName извлекает объект PlaylistArray , содержащий списки воспроизведения с указанным именем, если таковые существуют.

Синтаксис

retVal = PlaylistCollection.getByName(
  name
)

Параметры

name [in]: Строка , содержащая имена извлекаемых списков воспроизведения.

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

Этот метод возвращает объект PlaylistArray .

Примеры

В следующем примере JScript используется playlistCollection. getByName для проверка объекта playlistCollection для списка воспроизведения с именем ThreeList. Если список воспроизведения "Threelist" существует, getByName устанавливает "ThreeList" в качестве текущего списка воспроизведения. Объект Player был создан с идентификатором " Player".

//Retrieve the count of the playlists named "ThreeList".
var Checkit = Player.playlistCollection.getByName("ThreeList").count;

//Since duplicate playlist names are allowed, the count returned
//will be either zero (no playlist) or greater than zero 
//(playlist exists).
if (Checkit > 0){ 
    
   //Retrieve a playlistArray object containing "ThreeList". Assume that
   //there is only one playlist with that name, and assign it to the 
   //current playlist.
   Player.currentPlaylist = Player.playlistCollection.getByName("ThreeList").item(0);
}

Требования

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

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

Объект PlaylistArray
PlaylistArray.count
Объект PlaylistCollection
Settings.mediaAccessRights
Settings.requestMediaAccessRights