Controls.stop-Methode

Artikel
06/21/2023

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die stop-Methode beendet die Wiedergabe des Medienelements.

Syntax

Controls.stop()

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Diese Methode bewirkt, dass Windows Medienwiedergabe alle verwendeten Systemressourcen freigibt, z. B. das Audiogerät. Das aktuelle Medienelement wird jedoch nicht freigegeben.

Wenn der Player angehalten wird, wird der Track an den Anfang zurückspulen. Das Aufrufen der Wiedergabe beginnt dann mit der Wiedergabe des Clips von Anfang an. Verwenden Sie die Pause-Methode , um einen Wiedergabevorgang anzuhalten, ohne die aktuelle Position zu ändern.

Beispiele

Im folgenden Beispiel wird ein HTML BUTTON-Element erstellt, das stop verwendet, um die Wiedergabe zu beenden. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<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();
">

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

Controls-Objekt
Controls.next
Controls.pause
Controls.previous

Share via