Controls.next 方法

[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能,Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

Next 方法将当前项设置为播放列表中的下一项。

语法

Controls.next()

参数

此方法没有任何参数。

返回值

此方法不返回值。

备注

如果在调用 next 时播放列表位于最后一个条目上,则播放列表中的第一个条目将成为当前条目。

对于服务器端播放列表,此方法将跳到服务器端播放列表中的下一项,而不是客户端播放列表。

播放 DVD 时,此方法将跳到播放序列中的下一个逻辑章节,该章节可能不是播放列表中的下一章。 播放 DVD 静止时,此方法将跳到下一个静止。

示例

以下示例创建一个 HTML BUTTON 元素,该元素使用 next 移动到当前播放列表中的下一项。 创建的 Player 对象 ID 为“Player”。

<INPUT TYPE = "BUTTON"  ID = "NEXT"  NAME = "NEXT"  VALUE = ">>|"
    onClick = "

        /* Check first to be sure the operation is valid. */
        if (Player.controls.isAvailable('Next'))

            /* Move to the next item in the playlist. */
            Player.controls.next();
">

要求

要求
版本
Windows 媒体播放器版本 7.0 或更高版本。
DLL
Wmp.dll

另请参阅

Controls 对象

Controls.previous

Controls.stop