IWMPControls::next 方法

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

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

语法

public void next();

Public Sub next()
Implements IWMPControls.next

参数

此方法没有任何参数。

返回值

此方法不返回值。

备注

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

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

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

示例

以下示例使用 next 移动到当前播放列表中的下一项,以响应按钮的 Click 事件。 AxWMPLib.AxWindowsMediaPlayer 对象由名为 player 的变量表示。

private void nextButton_Click(object o, System.EventArgs args)
{
    // To get all of the available functionality of the player controls, cast the
    // value returned by player.Ctlcontrols to a WMPLib.IWMPControls3 interface. 
    WMPLib.IWMPControls3 controls = (WMPLib.IWMPControls3)player.Ctlcontrols;

    // Check first to be sure the operation is valid.
    if (controls.get_isAvailable("next"))
    {
        controls.next();
    }
}

Public Sub nextButton_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles nextButton.Click

    ' To get all of the available functionality of the player controls, Dim the
    ' value returned by player.Ctlcontrols as a WMPLib.IWMPControls3 interface.
    Dim controls As WMPLib.IWMPControls3 = player.Ctlcontrols

    ' Check first to be sure the operation is valid.
    If (controls.isAvailable("next")) Then

        controls.next()

    End If

End Sub

要求

要求
版本
Windows 媒体播放器 9 系列或更高版本
命名空间
WMPLib
程序集
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另请参阅

IWMPControls 接口 (VB 和 C#)

IWMPControls.previous (VB 和 C#)

IWMPControls.stop (VB 和 C#)