Controls.currentMarker

Artikel
06/21/2023

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

Die currentMarker-Eigenschaft gibt die aktuelle Markernummer an oder ruft sie ab.

player.controls.currentMarker

Mögliche Werte

Diese Eigenschaft ist eine Zahl mit Lese -/Schreibzugriff (long) mit dem Standardwert 0.

Hinweise

Das Festlegen von currentMarker bewirkt, dass die Wiedergabe mit dem angegebenen Marker beginnt. Bevor Sie versuchen, currentMarker festzulegen, bestimmen Sie mithilfe von markerCount, ob eine Datei Über Marker verfügt und wie viele sie hat. Wenn eine Datei über keine Marker verfügt, führt das Festlegen von currentMarker auf null zu einem Fehler. Das Festlegen von currentMarker auf eine Zahl höher als markerCount führt ebenfalls zu einem Fehler.

Die currentMarker-Eigenschaft gibt immer den aktuellen oder letzten Marker zurück, was bedeutet, dass sich die tatsächliche Dateiposition entweder am aktuellen Marker oder vor dem nächsten Marker befinden kann. Marker werden ab 1 nummeriert. Wenn eine Datei also Über Marker verfügt, können Sie currentMarker auf 0 festlegen, um die Dateiposition auf 0 zu ändern.

Bis das aktuelle Medienelement festgelegt ist (mit Player.URL oder Player. currentMedia), gibt currentMarker null zurück.

Beispiele

Im folgenden JScript-Beispiel wird currentMarker verwendet, um die Videowiedergabe über den Marker zu starten, der der selectedIndex-Eigenschaft eines HTML SELECT-Elements entspricht. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<SELECT ID = "markers"  NAME = "markers"  LANGUAGE = "JScript"

    /* Seek to the marker number that corresponds to the SELECT element
       selectedIndex value when the list selection changes. */
    onChange = "Player.controls.currentMarker = markers.selectedIndex + 1;
">

    /* Fill the SELECT element with the marker identifiers. */
    <OPTION SELECTED>Sunrise
    <OPTION>Car chase 
    <OPTION>Happy ending
</SELECT>

Anforderungen

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

Siehe auch

Controls-Objekt
Media.markerCount
Player.currentMedia
Player.URL

Freigeben über