VIDEO-Element

  • Artikel

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

Das VIDEO-Element bietet eine Möglichkeit, ein Videofenster in einer Skin mithilfe der folgenden Attribute und Ereignisse zu bearbeiten. Zur Vereinfachung wird auch ein vordefiniertes VIDEO-Element bereitgestellt.

Das VIDEO-Element unterstützt die folgenden Attribute.

attribute Beschreibung
Backgroundcolor Gibt die Hintergrundfarbe des Video-Steuerelements an oder ruft sie ab.
Cursor Gibt den Cursorwert an, der verwendet wird, wenn sich die Maus über einen anklickbaren Bereich des Videos befindet, oder ruft diesen ab.
Fullscreen Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob das Video im Vollbildmodus angezeigt wird. Kann nur zur Laufzeit festgelegt werden.
maintainAspectRatio Gibt einen Wert an, der angibt, ob das Video das Seitenverhältnis beibehält, wenn versucht wird, in die für das Steuerelement definierte Breite und Höhe zu passen, oder ruft diesen ab.
shrinkToFit Gibt einen Wert an, der angibt, ob das Video auf die für das Video-Steuerelement definierte Breite und Höhe verkleinern soll, oder ruft diesen ab.
stretchToFit Gibt einen Wert an, der angibt, ob sich das Video auf die für das Video-Steuerelement definierte Breite und Höhe erstreckt, oder ruft diesen ab.
Quickinfo Gibt den QuickInfo-Text für das Videofenster an oder ruft diese ab.
Windowless Gibt einen Wert an, der angibt, ob das Video-Steuerelement fenster- oder fensterlos ist, oder ruft einen Wert ab. Das heißt, ob das gesamte Rechteck des Steuerelements jederzeit sichtbar ist oder abgeschnitten werden kann. Kann nur zur Entwurfszeit festgelegt werden.
Zoom Gibt den Prozentsatz an, um den das Video skaliert werden soll.

 

Das VIDEO-Element kann die folgenden Ereignishandler implementieren.

Ereignishandler Beschreibung
onvideoend Behandelt ein Ereignis, das auftritt, wenn das Video nicht mehr gerendert und entladen wird.
onvideostart Behandelt ein Ereignis, das auftritt, wenn das Video geladen wird und mit dem Rendern beginnt.

 

Das VIDEO-Element unterstützt die Umgebungsattribute und kann die Umgebungsereignishandler implementieren, sofern nicht angegeben. Weitere Informationen finden Sie unter Umgebungsattribute und Umgebungsereignishandler.

Vordefinierte Videoelemente sind normale VIDEO-Elemente mit verschiedenen allgemeinen Attributeinstellungen, die standardmäßig angegeben sind. Die folgenden vordefinierten Videoelemente sind verfügbar.

Vordefiniertes VIDEO Beschreibung
WMPVIDEO Ein VIDEO-Element , das das Video dehnt, wenn die Größe geändert wird.

 

Referenz zur Skin-Programmierung