Player.fullScreen

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

fullScreen 属性指定或检索一个值，该值指示视频内容是否在全屏模式下播放。

语法

播放器 。全屏

可能的值

此属性是可读/写 Boolean 类型的值。

值	说明
是	视频内容在全屏模式下播放。
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 用于将嵌入式播放器对象切换到全屏模式。 创建 ID 为“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 对象