AmbientAttributes.clippingImage

  • 아티클

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

clippingImage 특성은 컨트롤을 클리핑할 영역을 지정하거나 검색합니다.

        elementID.clippingImage

가능한 값

이 특성은 이미지 파일 이름을 나타내는 읽기/쓰기 문자열 입니다. 기본값은 없습니다.

설명

clippingImage 특성은 PNG, JPG, BMP 및 GIF 파일(애니메이션 GIF를 포함하지 않음)을 지원합니다. JPG는 손실되므로 예기치 않은 색 변경이 발생할 수 있으므로 이미지를 클리핑하는 데 권장되지 않습니다.

이 특성은 전체 사각형 영역이 아닌 컨트롤 이미지의 일부만 표시하려는 경우에 유용합니다. clippingColor 특성은 컨트롤의 투명하고 클릭할 수 없는 부분에 해당하는 클리핑 이미지의 영역을 나타냅니다. 따라서 컨트롤은 모든 셰이프일 수 있습니다. 최상의 결과를 위해 클리핑 이미지는 컨트롤 이미지와 크기가 같아야 합니다.

clippingImage 특성은 PLAYLIST, VIEW 및 SUBVIEW 요소에서 지원되지 않습니다. VIDEO인 경우 클리핑 이미지가 VIDEO 요소와 함께 작동하지 않습니다. windowless는 false로 설정되거나 EFFECTS인 경우 EFFECTS 요소와 함께 설정됩니다. windowed는 true로 설정됩니다.

클리핑 이미지를 사용하면 성능 저하가 발생하므로 효율성이 문제가 될 때는 사용하지 않아야 합니다.

예제

이 특성의 사용을 보여 주는 샘플은 BUTTONELEMENT.mappingColor 특성을 참조하세요.

요구 사항

요구 사항 값
버전
 Windows 미디어 플레이어 버전 7.0 이상

추가 정보

주변 특성

AmbientAttributes.clippingColor