Player.uiMode

[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 uiMode-Eigenschaft gibt einen Wert an, der angibt, welche Steuerelemente auf der Benutzeroberfläche angezeigt werden.

Syntax

player . uiMode

Mögliche Werte

Diese Eigenschaft ist eine String-Eigenschaft mit Lese-/Schreibzugriff.

Wert	Beschreibung	Audiobeispiel	Videobeispiel
Unsichtbar	Windows Medienwiedergabe wird ohne sichtbare Benutzeroberfläche (Steuerelemente, Video- oder Visualisierungsfenster) eingebettet.	(Es wird nichts angezeigt.)	(Es wird nichts angezeigt.)
Keine	Windows Medienwiedergabe ist ohne Steuerelemente eingebettet, wobei nur das Video- oder Visualisierungsfenster angezeigt wird.
Mini	Windows Medienwiedergabe ist mit den neben dem Video- oder Visualisierungsfenster angezeigten status-Fenster, Wiedergabe/Pause, Beenden, Stummschalten und Lautstärke eingebettet.
Voll	Standard. Windows Medienwiedergabe ist zusätzlich zum Video- oder Visualisierungsfenster mit den Status-Fenster-, Suchleisten-, Wiedergabe-/Pausen-, Stopp-, Stummschalt-, Next-, Vorherigen-, Fast Forward-, Fast Reverse- und Volume-Steuerelementen eingebettet.
custom	Windows Medienwiedergabe ist mit einer benutzerdefinierten Benutzeroberfläche eingebettet. Kann nur in C++-Programmen verwendet werden.	(Benutzerdefinierte Benutzeroberfläche wird angezeigt.)	(Benutzerdefinierte Benutzeroberfläche wird angezeigt.)

Bemerkungen

Diese Eigenschaft gibt die Darstellung des eingebetteten Windows Medienwiedergabe an. Wenn uiMode auf "none", "mini" oder "full" festgelegt ist, ist ein Fenster für die Anzeige von Videoclips und Audiovisualisierungen vorhanden. Dieses Fenster kann im Mini- oder Vollmodus ausgeblendet werden, indem das Height-Attribut des OBJECT-Tags auf 40 festgelegt wird, was von unten gemessen wird und den Steuerelementteil der Benutzeroberfläche sichtbar lässt. Wenn keine eingebettete Schnittstelle gewünscht ist, legen Sie sowohl das Breiten - als auch das Höhenattribute auf 0 fest.

Wenn uiMode auf "unsichtbar" festgelegt ist, wird keine Benutzeroberfläche angezeigt, aber der Platz auf der Seite ist weiterhin reserviert, wie durch Breite und Höhe angegeben. Dies ist nützlich, um das Seitenlayout beizubehalten, wenn uiMode sich ändern kann. Darüber hinaus ist der reservierte Speicherplatz transparent, sodass alle Elemente, die sich hinter dem Steuerelement befinden, sichtbar sind.

Wenn uiMode auf "full" oder "mini" festgelegt ist, zeigt Windows Medienwiedergabe Transportsteuerelemente im Vollbildmodus an. Wenn uiMode auf "none" festgelegt ist, werden keine Steuerelemente im Vollbildmodus angezeigt.

Wenn das Fenster sichtbar ist und Audioinhalte wiedergegeben werden, wird die visualisierung angezeigt, die zuletzt in Windows Medienwiedergabe verwendet wurde.

Wenn uiMode in einem C++-Programm, das IWMPRemoteMediaServices implementiert, auf "benutzerdefiniert" festgelegt ist, wird die von IWMPRemoteMediaServices::GetCustomUIMode angegebene Skindatei angezeigt.

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

Beispiele

Im folgenden Beispiel wird ein HTML SELECT-Element erstellt, mit dem der Benutzer die Benutzeroberfläche für ein eingebettetes Player-Objekt ändern kann. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<!-- Create an HTML SELECT element. -->
<SELECT  ID = UI  LANGUAGE="JScript"

         /* Specify the UI mode the user selects. */
         onChange = "Player.uiMode = UI.value">

/* These are the four UI mode options. */
<OPTION VALUE="invisible">Invisible
<OPTION VALUE="none">No Controls
<OPTION VALUE="mini">Mini Player
<OPTION VALUE="full">Full Player
</SELECT>

Windows Medienwiedergabe 10 Mobile: Diese Eigenschaft akzeptiert oder gibt nur Werte von "none" oder "full" zurück. Auf Smartphone-Geräten werden nur die Wiedergabe status und ein Zähler angezeigt, wenn uiMode auf "full" festgelegt ist.

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher. Windows Medienwiedergabe Serie 9 oder höher für "unsichtbar" oder "benutzerdefinierte".
DLL	Wmp.dll

Siehe auch

IWMPRemoteMediaServices-Schnittstelle

IWMPRemoteMediaServices::GetCustomUIMode

Player-Objekt