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 |
|
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈