AxWindowsMediaPlayer.uiMode 属性

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

uiMode 属性获取或设置一个值，该值指示哪些控件显示在用户界面中。

语法

public System.String uiMode {get; set;}

Public Property uiMode As System.String

属性值

一个 System.String，它是以下值之一。

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

备注

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

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

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

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

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

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

示例

以下示例创建一个列表框，该列表框允许用户更改嵌入式Windows 媒体播放器 对象的用户界面模式。 AxWMPLib.AxWindowsMediaPlayer 对象由名为 player 的变量表示。

// Load the list box with the four UI mode options.
uiModeOptions.Items.Add("invisible");
uiModeOptions.Items.Add("none");
uiModeOptions.Items.Add("mini");
uiModeOptions.Items.Add("full");


private void uiModeOptions_OnSelectedIndexChanged(object sender, System.EventArgs e)
{
    // Get the selected UI mode in the list box as a string.
    string newMode = (string)(((System.Windows.Forms.ListBox)sender).SelectedItem);
     
    // Set the UI mode that the user selected.
    player.uiMode = newMode;            
}

' Load the list box with the four UI mode options.
uiModeOptions.Items.Add("invisible")
uiModeOptions.Items.Add("none")
uiModeOptions.Items.Add("mini")
uiModeOptions.Items.Add("full")


Public Sub uiModeOptions_OnSelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles uiModeOptions.SelectedIndexChanged

    ' Get the selected UI mode in the list box as a string.
    Dim lb As System.Windows.Forms.ListBox = sender
    Dim newMode As String = lb.SelectedItem

    ' Set the UI mode that the user selected.
    player.uiMode = newMode

End Sub

要求

要求	值
版本	Windows 媒体播放器版本 7.0 或更高版本。 Windows 媒体播放器 9 系列或更高版本，用于“不可见”或“自定义”
命名空间	AxWMPLib
程序集	AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

另请参阅

AxWindowsMediaPlayer 对象 (VB 和 C#)

AxWindowsMediaPlayer.enableContextMenu (VB 和 C#)