Controls.stop, méthode

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode stop arrête la lecture de l’élément multimédia.

Syntaxe

Controls.stop()

Paramètres

Cette méthode n’a aucun paramètre.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Cette méthode entraîne Lecteur multimédia Windows libérer toutes les ressources système qu’il utilise, telles que le périphérique audio. Toutefois, l’élément multimédia actuel n’est pas libéré.

Lorsque le joueur est arrêté, la piste rembobine au début. La lecture de l’appel commence alors la lecture du clip à partir du début. Pour arrêter une opération de lecture sans modifier la position actuelle, utilisez la méthode pause .

Exemples

L’exemple suivant crée un élément HTML BUTTON qui utilise stop pour arrêter la lecture. L’objet Player a été créé avec 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();
">

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Controls, objet

Controls.next

Controls.pause

Controls.previous