Controls.stop 方法

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

stop 方法停止播放媒体项。

语法

Controls.stop()

parameters

此方法没有任何参数。

返回值

此方法不返回值。

备注

此方法使Windows 媒体播放器释放它使用的任何系统资源，例如音频设备。 但是，当前媒体项未发布。

当玩家停止时，轨道将倒退到开头。 调用 播放 将从头开始播放剪辑。 若要在不更改当前位置的情况下停止播放操作，请使用 pause 方法。

示例

以下示例创建一个 HTML BUTTON 元素，该元素使用 stop 停止播放。 创建 ID 为“Player”的 Player 对象。

<INPUT TYPE = "BUTTON"  ID = "STOP"  NAME = "STOP"  VALUE = "Stop"
    onClick = "

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

            /* Stop the Player. */
            Player.controls.stop();
">

要求

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

另请参阅

Controls 对象

Controls.next

Controls.pause

Controls.previous