Cdrom.playlist

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

playlist屬性會擷取Playlist物件，代表 CD 磁片磁碟機中目前 CD 上的曲目或 DVD 的根層級標題專案。

player.cdromCollection.item(
        index
        ).playlist
      

可能的值

此屬性是唯讀 的 Playlist 物件。

備註

一般而言，DVD 會組織成標題。 每個標題都包含一或多個章節。 每個 DVD 都是以不同的方式撰寫，因此標題和章節的使用方式會由內容作者決定。

若為 DVD，此方法會擷取包含作為代表 DVD 媒體之 Media 物件的第一個專案的播放清單。 播放專案會導致 DVD 從頭播放，如果是插入新 DVD 之後的第一個播放，或如果 DVD 與上次檢視的 DVD 相同，則繼續播放。 在播放期間將此專案設定為目前的專案，會導致 DVD 從頭播放。

播放清單中) 的 媒體 物件 (其他專案是巢狀播放清單所代表的 DVD 標題。 當您指定控制項時。currentItem等於其中一個巢狀播放清單專案，Windows 媒體播放機會自動將巢狀播放清單設定為Player。在章節播放開始之後，currentPlaylist。 然後，您可以使用 currentPlaylist 物件屬性、方法和事件來處理 DVD 章節，亦即播放清單專案。

若要擷取這個屬性的值，需要程式庫的讀取權限。 如需詳細資訊，請參閱 程式庫存取。

Windows 媒體播放機 10 行動裝置版：不支援此屬性。

範例

下列範例使用 Cdrom。播放清單 ，以填入名為 myText 的 HTML 文字元素，以及目前位於第一個 CD 磁片磁碟機中的音訊 CD 標題。 使用 CdromCollection。要 判斷可用 CD 磁片磁碟機數目的計數。 Player物件是以識別碼 = 「Player」 建立的。

// Store the CD playlist object.
var pl = Player.cdromCollection.Item(0).Playlist;

// Iterate through the CD track list.
for(var i = 0; i < pl.count; i++){

   // Print each CD track name.
   myText.value += pl.Item(i).name + "\n"; 
}

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
版本	Windows 媒體播放機 7.0 版或更新版本。
DLL	Wmp.dll

另請參閱

Cdrom 物件

Settings.mediaAccessRights

Settings.requestMediaAccessRights