PlaylistCollection.newPlaylist 方法

newPlaylist方法會在文件庫中建立新的播放清單。

語法

retVal = PlaylistCollection.newPlaylist(
  name
)

參數

name [in]

包含 要建立之播放清單名稱的字串。

傳回值

這個方法會傳回 Playlist 物件。

備註

此方法會在文件庫中建立空的播放清單。 若要使用媒體專案填入播放清單,請使用 播放清單appendItemPlaylistinsertItem

文件庫中允許多個具有相同名稱的播放清單。 若要避免使用此方法建立重複的播放清單名稱,請使用 getByNamePlaylistArraycount ,以判斷具有特定名稱的播放清單是否已經存在。

播放清單名稱中不允許開頭和尾端空格,而且會自動從 為 name 參數指定的值中移除。

若要使用這個方法,需要程式庫的完整存取權。 如需詳細資訊,請參閱 程式庫存取

範例

下列JScript範例會建立名為 「ThreeList」 的新空白播放清單。 Player物件是使用 ID=「Player」 建立的。

//Add a new empty playlist, named ThreeList, to the playlist collection.
var NewList = Player.playlistCollection.newPlaylist("ThreeList");

規格需求

需求
版本
Windows 媒體播放機 7.0 版或更新版本。
DLL
Wmp.dll

另請參閱

MediaCollection.add

Playlist.appendItem

Playlist.insertItem

PlaylistArray.count

PlaylistCollection 物件

PlaylistCollection.getByName

PlaylistCollection.importPlaylist

PlaylistCollection.remove

設定.mediaAccessRights

設定.requestMediaAccessRights