Player.uiMode

發行項
06/21/2023

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

uiMode屬性會指定或擷取值，指出使用者介面中顯示的控制項。

Syntax

播放程式 。uiMode

可能的值

此屬性是可讀寫 的 String。

值	描述	音訊範例	影片範例
不可見的	Windows 媒體播放機內嵌，而沒有任何可見的使用者介面 (控制項、視訊或視覺效果視窗) 。	(Nothing 隨即顯示。)	(Nothing 隨即顯示。)
無	Windows 媒體播放機內嵌沒有控制項，而且只顯示視訊或視覺效果視窗。
迷你	除了視訊或視覺效果視窗之外，Windows 媒體播放機會內嵌狀態視窗、播放/暫停、停止、靜音和音量控制項。
完整	預設值。除了視訊或視覺效果視窗之外，Windows 媒體播放機內嵌狀態視窗、搜尋列、播放/暫停、停止、靜音、下一個、上一個、快速向前、快速反向和音量控制項。
自訂	Windows 媒體播放機內嵌于自訂使用者介面。只能在 C++ 程式中使用。	(顯示自訂使用者介面。)	(顯示自訂使用者介面。)

備註

此屬性會指定內嵌Windows 媒體播放機的外觀。當 uiMode 設定為「none」、「mini」或「full」時，會顯示視訊剪輯和音訊視覺效果的視窗。此視窗可以在迷你或完整模式中隱藏，方法是將OBJECT標籤的高度屬性設定為 40，這會從底部測量，並讓使用者介面的控制項部分保持可見。如果不需要內嵌介面，請將寬度和高度屬性都設定為零。

如果 uiMode 設定為「不可見」，則不會顯示任何使用者介面，但空間仍會保留于頁面上，如寬度和高度所指定。這適用于在 uiMode 變更時保留版面配置。此外，保留空間是透明的，因此控制項後方階層式任何元素都會可見。

如果uiMode設定為「full」或「mini」，Windows 媒體播放機以全螢幕模式顯示傳輸控制項。如果 uiMode 設定為「none」，則不會以全螢幕模式顯示任何控制項。

如果視窗可見且現正播放音訊內容，顯示的視覺效果將會是最近用於Windows 媒體播放機的視覺效果。

如果 uiMode 在實作 IWMPRemoteMediaServices的 C++ 程式中設定為「custom」，則會顯示 IWMPRemoteMediaServices：：GetCustomUIMode 所指示的面板檔案。

在全螢幕播放期間，當enableCoNtextMenu等於 false 且uiMode等於「none」時，Windows 媒體播放機隱藏滑鼠游標。

範例

下列範例會建立 HTML SELECT 元素，讓使用者變更內嵌 Player 物件的使用者介面。 Player物件是以識別碼 = 「Player」建立的。

<!-- 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 媒體播放機 10 Mobile：此屬性只接受或傳回「none」或「full」的值。在智慧型手機裝置上，只有在 uiMode 設為 [完整] 時，才會顯示播放狀態和計數器。

規格需求

需求	值
版本	Windows 媒體播放機 7.0 版或更新版本。 Windows 媒體播放機 9 系列或更新版本，以取得「不可見」或「自訂」。
DLL	Wmp.dll

另請參閱

IWMPRemoteMediaServices 介面
IWMPRemoteMediaServices：：GetCustomUIMode
Player 物件