Controls.stop メソッド

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

stop メソッドは、メディア項目の再生を停止します。

構文

Controls.stop()

パラメーター

このメソッドにはパラメーターはありません。

戻り値

このメソッドは値を返しません。

解説

このメソッドにより、Windows メディア プレーヤーは、オーディオ デバイスなど、使用しているシステム リソースを解放します。 ただし、現在のメディア項目はリリースされません。

プレーヤーが停止すると、トラックは先頭に巻き戻されます。 再生を呼び出すと、クリップの再生が最初から開始されます。 現在の位置を変更せずに再生操作を停止するには、 pause メソッドを使用します。

例

次の例では、 stop を使用して再生を停止する HTML BUTTON 要素を作成します。 Player オブジェクトは ID = "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();
">

必要条件

要件 値
Version
 バージョン 7.0 以降をWindows メディア プレーヤーします。
[DLL]
Wmp.dll

関連項目

Controls オブジェクト

Controls.next

Controls.pause

Controls.previous