Controls-Objekt

[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.]

Das Controls-Objekt bietet eine Möglichkeit, die Wiedergabe von Medien mithilfe der folgenden Eigenschaften und Methoden zu bearbeiten.

Das Controls-Objekt unterstützt die folgenden Eigenschaften.

Eigenschaft	Beschreibung
audioLanguageCount	Ruft die Anzahl der unterstützten Audiosprachen ab.
currentAudioLanguage	Gibt den Gebietsschemabezeichner (LCID) der Audiosprache für die Wiedergabe an oder ruft sie ab.
currentAudioLanguageIndex	Gibt den 1-basierten Index an, der der Audiosprache für die Wiedergabe entspricht, oder ruft diesen ab.
Currentitem	Gibt das aktuelle Medienelement an oder ruft es ab.
currentMarker	Gibt die aktuelle Markernummer an oder ruft sie ab.
currentPosition	Gibt die aktuelle Position im Medienelement in Sekunden von Anfang an an oder ruft sie ab.
currentPositionString	Ruft die aktuelle Position im Medienelement als Zeichenfolge ab.
currentPositionTimecode	Gibt die aktuelle Position im aktuellen Medienelement mithilfe eines Zeitcodeformats an oder ruft sie ab. Diese Eigenschaft unterstützt derzeit SMPTE-Zeitcode.
Isavailable	Ruft ab, ob ein angegebener Informationstyp verfügbar ist oder eine bestimmte Aktion ausgeführt werden kann.

 

Das Controls-Objekt unterstützt die folgenden Methoden.

Methode	Beschreibung
Fastforward	Startet die schnelle Wiedergabe des Medienelements in Vorwärtsrichtung.
fastReverse	Startet die schnelle Wiedergabe des Medienelements in umgekehrter Richtung.
getAudioLanguageDescription	Ruft die Beschreibung für die Audiosprache ab, die dem angegebenen 1-basierten Index entspricht.
getAudioLanguageID	Ruft die LCID für einen angegebenen Audiosprachindex ab.
getLanguageName	Ruft den Namen der Audiosprache mit der angegebenen LCID ab.
Weiter	Legt das aktuelle Element auf das nächste Element in der Wiedergabeliste fest.
pause	Hält die Wiedergabe des Medienelements an.
play	Bewirkt, dass das Medienelement mit der Wiedergabe beginnt.
playItem	Bewirkt, dass das aktuelle Medienelement mit der Wiedergabe beginnt oder die Wiedergabe eines angehaltenen Elements fortgesetzt wird.
previous	Legt das aktuelle Element auf das vorherige Element in der Wiedergabeliste fest.
step	Bewirkt, dass das aktuelle Videomedienelement die Wiedergabe im nächsten Frame einfriert.
stop	Beendet die Wiedergabe des Medienelements.

 

Der Zugriff auf das Controls-Objekt erfolgt über die folgende Eigenschaft.

Object	Eigenschaft
Player	Steuerelemente

 

Siehe auch

Objektmodellreferenz für Skripterstellung