AxWindowsMediaPlayer.uiMode 屬性

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

uiMode 屬性會取得或設定值，指出使用者介面中顯示的控制項。

Syntax

public System.String uiMode {get; set;}

Public Property uiMode As System.String

屬性值

System.String，其為下列其中一個值。

值	描述	音訊範例	影片範例
不可見的	Windows 媒體播放機內嵌，沒有任何可見的使用者介面 (控制項、視訊或視覺效果視窗) 。	(顯示 Nothing。)	(顯示 Nothing。)
無	Windows 媒體播放機內嵌沒有控制項，而且只會顯示視訊或視覺效果視窗。
迷你	除了視訊或視覺效果視窗之外，Windows 媒體播放機內嵌于狀態視窗、播放/暫停、停止、靜音和音量控制項。
完整	預設值。 除了視訊或視覺效果視窗之外，Windows 媒體播放機內嵌于狀態視窗、搜尋列、播放/暫停、停止、靜音、下一個、上一個、向前快轉、倒轉和音量控制項。
自訂	Windows 媒體播放機內嵌于自訂使用者介面。 只能在 C++ 程式中使用。	(顯示自訂使用者介面。)	(顯示自訂使用者介面。)

備註

此屬性會指定內嵌Windows 媒體播放機的外觀。 當 uiMode 設定為 「none」、「mini」 或 「full」時，會顯示視訊剪輯和音訊視覺效果的視窗。 您可以將OBJECT標籤的高度屬性設定為 40，以迷你或完整模式隱藏此視窗，這會從底部測量，並讓使用者介面的控制項部分保持可見。 如果不需要內嵌介面，請將 寬度 和 高度 屬性都設定為零。

如果 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#)