Player.uiMode

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

uiMode 属性指定或检索一个值，该值指示用户界面中显示的控件。

语法

player 。uiMode

可能的值

此属性是读/写 字符串。

值	说明	音频示例	视频示例
不可见	Windows 媒体播放器嵌入时没有任何可见的用户界面 (控件、视频或可视化效果窗口) 。	(不显示任何内容。)	(不显示任何内容。)
无	Windows 媒体播放器嵌入时没有控件，并且仅显示视频或可视化效果窗口。
mini	除了视频或可视化效果窗口外，Windows 媒体播放器还嵌入了状态窗口、播放/暂停、停止、静音和音量控件。
full	默认。 除了视频或可视化窗口之外，Windows 媒体播放器还嵌入了状态窗口、搜寻栏、播放/暂停、停止、静音、下一个、上一个、快进、快速反向和音量控件。
自定义	Windows 媒体播放器嵌入了自定义用户界面。 只能在 C++ 程序中使用。	(显示自定义用户界面。)	(显示自定义用户界面。)

注解

此属性指定嵌入Windows 媒体播放器的外观。 当 uiMode 设置为“none”、“mini”或“full”时，将显示一个用于显示视频剪辑和音频可视化效果的窗口。 通过将 OBJECT 标记的高度属性设置为 40（从底部测量），可以在微型或完整模式下隐藏此窗口，并使用户界面的控件部分可见。 如果不需要嵌入接口，请将 width 和 height 属性都设置为零。

如果 uiMode 设置为“invisible”，则不显示任何用户界面，但页面上仍保留宽度和高度指定的空间。 当 uiMode 可以更改时，这对于保留页面布局很有用。 此外，保留的空间是透明的，因此，在控件后面分层的任何元素都将可见。

如果 uiMode 设置为“full”或“mini”，Windows 媒体播放器以全屏模式显示传输控件。 如果 uiMode 设置为“none”，则全屏模式下不会显示任何控件。

如果窗口可见且正在播放音频内容，则显示的可视化效果将是Windows 媒体播放器中最近使用的可视化效果。

如果在实现 IWMPRemoteMediaServices 的 C++ 程序中将 uiMode 设置为“custom”，则显示由 IWMPRemoteMediaServices：：GetCustomUIMode 指示的皮肤文件。

在全屏播放期间，当 enableContextMenu 等于 false 且 uiMode 等于“none”时，Windows 媒体播放器隐藏鼠标光标。

示例

以下示例创建一个 HTML SELECT 元素，该元素允许用户更改嵌入 的 Player 对象的用户界面。 创建的 Player 对象 ID 为“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 设置为“full”时，仅显示播放状态和计数器。

要求

要求	值
版本	Windows 媒体播放器版本 7.0 或更高版本。 对于“不可见”或“自定义”，Windows 媒体播放器 9 系列或更高版本。
DLL	Wmp.dll

另请参阅

IWMPRemoteMediaServices 接口

IWMPRemoteMediaServices：：GetCustomUIMode

Player 对象