Player.uiMode

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

uiMode 속성은 사용자 인터페이스에 표시되는 컨트롤을 나타내는 값을 지정하거나 검색합니다.

Syntax

플레이어 . uiMode

가능한 값

이 속성은 읽기/쓰기 문자열입니다.

값	설명	오디오 예제	비디오 예제
보이지 않는 상태	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 미디어 플레이어 마우스 커서를 숨깁니다.

예제

다음 예제에서는 사용자가 포함된 Player 개체의 사용자 인터페이스를 변경할 수 있는 HTML SELECT 요소를 만듭니다. 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 이상. "보이지 않는" 또는 "사용자 지정"에 대해 9 시리즈 이상을 Windows 미디어 플레이어.
DLL	Wmp.dll

추가 정보

IWMPRemoteMediaServices 인터페이스

IWMPRemoteMediaServices::GetCustomUIMode

Player 개체