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，此方法检索一个播放列表，该播放列表包含作为第一项的 Media 对象，该对象表示 DVD 媒体。 如果这是插入新 DVD 后的第一次播放，则播放该项目会导致 DVD 从头开始播放;如果 DVD 与查看的最后一个 DVD 相同，则恢复播放。 在播放期间将此项设置为当前项目会导致 DVD 从头开始播放。

播放列表中) (Media 对象的其他项目是由嵌套播放列表表示的 DVD 标题。 指定控件时。currentItem 等于其中一个嵌套播放列表项，Windows 媒体播放器自动将嵌套播放列表设置为 Player。章节播放开始后的 currentPlaylist。 然后，可以使用 currentPlaylist 对象属性、方法和事件来处理 DVD 章节，这些章节也是播放列表项。

若要检索此属性的值，需要对库的读取访问权限。 有关详细信息，请参阅 库访问。

Windows 媒体播放器 10 移动版：不支持此属性。

示例

以下示例使用 Cdrom。播放列表 ，用于填充名为 myText 的 HTML 文本元素，其中包含当前位于第一个 CD 驱动器中的音频 CD 的标题。 使用 CdromCollection。用于 确定可用 CD 驱动器数的计数。 创建的 Player 对象 ID 为“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