Share via

EFFECTS 요소

  • 아티클

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

EFFECTS 요소는 다음 특성과 메서드를 사용하여 시각화를 구성하고 조작하는 방법을 제공합니다. 편의를 위해 미리 정의된 EFFECTS 요소도 제공됩니다.

EFFECTS 요소는 다음 특성을 지원합니다.

attribute 설명
allowAll 레지스트리에 모든 시각화를 포함할지 여부를 나타내는 값을 지정하거나 검색합니다.
currentEffect 현재 시각화를 지정하거나 검색합니다.
currentEffectPresetCount 현재 시각화에 사용할 수 있는 사전 설정 수를 검색합니다.
currentEffectTitle 현재 시각화의 표시 제목을 검색합니다.
currentEffectType 현재 시각화의 레지스트리 이름을 검색합니다.
currentPreset 현재 시각화의 현재 사전 설정을 지정하거나 검색합니다.
currentPresetTitle 현재 시각화의 현재 사전 설정 제목을 검색합니다.
effectCanGoFullScreen 현재 시각화를 전체 화면으로 표시할 수 있는지 여부를 나타내는 값을 검색합니다.
effectCount 사용 가능한 시각화 수를 검색합니다.
effectHasPropertyPage 현재 시각화에 속성 페이지가 있는지 여부를 나타내는 값을 검색합니다.
fullScreen 현재 시각화가 전체 화면으로 표시되는지 여부를 나타내는 값을 지정하거나 검색합니다. 런타임에만 설정할 수 있습니다.
창 시각화가 창이 없는지 창이 없는지, 즉 컨트롤의 전체 사각형을 항상 표시할지 또는 잘릴 수 있는지 여부를 나타내는 값을 지정하거나 검색합니다. 디자인 타임에만 설정할 수 있습니다.

 

EFFECTS 요소는 다음 메서드를 지원합니다.

메서드 설명
effectTitle 지정된 레지스트리 인덱스를 사용하여 시각화의 이름을 검색합니다.
effectType 지정된 레지스트리 인덱스를 사용하여 시각화의 레지스트리 이름을 검색합니다.
다음 필요한 경우 다음 시각화로 이동하여 다음 시각화 사전 설정을 표시합니다.
nextEffect 중간 사전 설정을 건너뛰고 다음 시각화의 첫 번째 사전 설정을 표시합니다.
nextPreset 현재 시각화의 다음 사전 설정을 표시합니다.
previous 필요한 경우 이전 시각화의 마지막 사전 설정으로 이동하는 이전 시각화 사전 설정을 표시합니다.
previousEffect 사전 설정을 건너뛰고 이전 시각화를 표시합니다.
previousPreset 현재 시각화의 이전 사전 설정을 표시합니다.
설정 현재 시각화에 대한 특성 페이지(있는 경우)를 표시합니다.

 

EFFECTS 요소는 주변 특성을 지원하고 앰비언트 이벤트 처리기를 구현할 수 있습니다. 자세한 내용은 앰비언트 특성 및 주변 이벤트 처리기를 참조하세요.

미리 정의된 효과는 기본적으로 지정된 다양한 공통 특성 설정이 있는 일반 EFFECTS 요소입니다. 다음과 같은 미리 정의된 효과를 사용할 수 있습니다.

미리 정의된 효과 설명
WMPEFFECTS 사용 가능한 효과를 반복하는 EFFECTS 요소입니다.

 

스킨 프로그래밍 참조