Player.fullScreen

[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 fullScreen-Eigenschaft gibt einen Wert an oder ruft einen Wert ab, der angibt, ob Videoinhalte im Vollbildmodus wiedergegeben werden.

Syntax

player . Fullscreen

Mögliche Werte

Diese Eigenschaft ist ein Boolean-Wert mit Lese-/Schreibzugriff.

Wert	BESCHREIBUNG
true	Videoinhalte werden im Vollbildmodus wiedergegeben.
false	Standard. Videoinhalte werden nicht im Vollbildmodus wiedergegeben.

Bemerkungen

Damit der Vollbildmodus beim Einbetten des Windows Medienwiedergabe-Steuerelements ordnungsgemäß funktioniert, muss der Videoanzeigebereich eine Höhe und Breite von mindestens einem Pixel aufweisen. Wenn uiMode auf "mini" oder "full" festgelegt ist, muss die Höhe des Steuerelements selbst 65 oder höher betragen, um den Videoanzeigebereich zusätzlich zur Benutzeroberfläche aufzunehmen.

Wenn uiMode auf "unsichtbar" festgelegt ist, löst das Festlegen dieser Eigenschaft auf true einen Fehler aus und wirkt sich nicht auf das Verhalten des Steuerelements aus.

Während der Vollbildwiedergabe blendet Windows Medienwiedergabe den Mauscursor aus, wenn enableContextMenu gleich false und uiMode gleich "none" ist.

Wenn uiMode auf "full" oder "mini" festgelegt ist, zeigt Windows Medienwiedergabe Transportsteuerelemente im Vollbildmodus an, wenn der Mauscursor bewegt wird. Nach einem kurzen Intervall ohne Mausbewegung werden die Transportsteuerelemente ausgeblendet. Wenn uiMode auf "none" festgelegt ist, werden keine Steuerelemente im Vollbildmodus angezeigt.

Hinweis

Zum Anzeigen von Transportsteuerelementen im Vollbildmodus ist das Betriebssystem Windows XP erforderlich.

Wenn Transportsteuerelemente nicht im Vollbildmodus angezeigt werden, beendet Windows Medienwiedergabe automatisch den Vollbildmodus, wenn die Wiedergabe beendet wird.

Hinweis

Achten Sie immer darauf, den Benutzer darüber zu informieren, wie er aus dem Vollbildmodus zurückkehren kann.

Beispiele

Im folgenden Beispiel wird eine HTML-Eingabeschaltfläche erstellt, die Player verwendet. fullScreen , um ein eingebettetes Playerobjekt in den Vollbildmodus zu wechseln. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<INPUT type = button 
       value = "Full Screen" 
       name = FSBUTTON
       onclick = "
               /* Check to be sure the player is playing. */
               if (Player.playState == 3) 
                  Player.fullScreen = 'true';
               ">

Anforderungen

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

Siehe auch

Player-Objekt