Player.fullScreen

發行項
06/21/2023

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

fullScreen屬性會指定或擷取值，指出是否以全螢幕模式播放視訊內容。

Syntax

播放程式 。全屏

可能的值

這個屬性是可讀寫 的 Boolean。

值	描述
true	視訊內容會以全螢幕模式播放。
false	預設值。影片內容不會以全螢幕模式播放。

備註

若要讓全螢幕模式在內嵌Windows 媒體播放機控制項時正常運作，視訊顯示區域必須具有至少一個圖元的高度和寬度。如果 uiMode 設定為「mini」或「full」，除了使用者介面之外，控制項本身的高度必須是 65 或更新版本，才能容納視訊顯示區域。

如果 uiMode 設定為「invisible」，則將此屬性設定為 true 會引發錯誤，且不會影響控制項的行為。

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

如果uiMode設定為「full」或「mini」，Windows 媒體播放機滑鼠游標移動時，以全螢幕模式顯示傳輸控制項。在沒有滑鼠移動的簡短間隔之後，傳輸控制項就會隱藏。如果 uiMode 設定為「none」，則不會以全螢幕模式顯示任何控制項。

注意

以全螢幕模式顯示傳輸控制項需要 Windows XP 作業系統。

如果傳輸控制項未以全螢幕模式顯示，則當播放停止時，Windows 媒體播放機會自動結束全螢幕模式。

注意

請務必通知使用者如何從全螢幕模式傳回。

範例

下列範例會建立使用 Player的 HTML 輸入按鈕。fullScreen 將內嵌播放程式物件切換為全螢幕模式。 Player物件是以識別碼 = 「Player」建立的。

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

規格需求

需求	值
版本	Windows 媒體播放機 7.0 版或更新版本。
DLL	Wmp.dll

另請參閱

Player 物件