AxWindowsMediaPlayer.uiMode 속성

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

uiMode 속성은 사용자 인터페이스에 표시되는 컨트롤을 나타내는 값을 가져오거나 설정합니다.

구문

public System.String uiMode {get; set;}

Public Property uiMode As System.String

속성 값

다음 값 중 하나인 System.String입니다.

값	설명	오디오 예제	비디오 예제
보이지 않는 상태	Windows 미디어 플레이어 표시되는 사용자 인터페이스(컨트롤, 비디오 또는 시각화 창) 없이 포함됩니다.	(아무것도 표시되지 않습니다.)	(아무것도 표시되지 않습니다.)
없음	Windows 미디어 플레이어 컨트롤 없이 포함되며 비디오 또는 시각화 창만 표시됩니다.
미니	Windows 미디어 플레이어 비디오 또는 시각화 창 외에도 표시되는 상태 창, 재생/일시 중지, 중지, 음소거 및 볼륨 컨트롤과 함께 포함됩니다.
전체	기본값 Windows 미디어 플레이어 비디오 또는 시각화 창 외에도 상태 창, 검색 막대, 재생/일시 중지, 중지, 음소거, 다음, 이전, 빠른 앞으로, 되감기 및 볼륨 컨트롤과 함께 포함됩니다.
custom	Windows 미디어 플레이어 사용자 지정 사용자 인터페이스와 함께 포함됩니다. C++ 프로그램에서만 사용할 수 있습니다.	(사용자 지정 사용자 인터페이스가 표시됩니다.)	(사용자 지정 사용자 인터페이스가 표시됩니다.)

설명

이 속성은 포함된 Windows 미디어 플레이어 모양을 지정합니다. uiMode를 "none", "mini" 또는 "full"로 설정하면 비디오 클립 및 오디오 시각화를 표시하기 위한 창이 표시됩니다. 이 창은 개체 태그의 높이 특성을 40으로 설정하여 미니 또는 전체 모드로 숨길 수 있습니다. 이 특성은 아래쪽에서 측정되며 사용자 인터페이스의 컨트롤 부분을 볼 수 있습니다. 포함된 인터페이스가 없으면 너비 와 높이 특성을 모두 0으로 설정합니다.

uiMode가 "보이지 않음"으로 설정된 경우 사용자 인터페이스는 표시되지 않지만 너비와 높이로 지정된 대로 페이지에 공간이 예약되어 있습니다. 이는 uiMode 를 변경할 수 있는 경우 페이지 레이아웃을 유지하는 데 유용합니다. 또한 예약된 공간은 투명하므로 컨트롤 뒤에 계층화된 모든 요소가 표시됩니다.

uiMode가 "full" 또는 "mini"로 설정된 경우 Windows 미디어 플레이어 전송 컨트롤을 전체 화면 모드로 표시합니다. uiMode가 "none"으로 설정된 경우 컨트롤이 전체 화면 모드로 표시되지 않습니다.

창이 표시되고 오디오 콘텐츠가 재생되는 경우 표시되는 시각화는 가장 최근에 Windows 미디어 플레이어 사용됩니다.

IWMPRemoteMediaServices를 구현하는 C++ 프로그램에서 uiMode가 "사용자 지정"으로 설정된 경우 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#)