PlaylistCollection.getByName 方法

getByName方法會擷取包含具有指定名稱之播放清單的PlaylistArray物件,如果有的話。

語法

retVal = PlaylistCollection.getByName(
  name
)

參數

name [in]

字串 ,其中包含要擷取的播放清單名稱。

傳回值

這個方法會傳回 PlaylistArray 物件。

備註

使用 PlaylistArray 判斷播放清單是否存在的計數。 如果 count 為零,則播放清單不存在。

若要使用此方法,需要程式庫的讀取權限。 如需詳細資訊,請參閱 程式庫存取

範例

下列JScript範例使用playlistCollectiongetByName可檢查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 物件

設定.mediaAccessRights

設定.requestMediaAccessRights