MediaElement.Stretch 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
대상 사각형을 채우기 위해 MediaElement 를 확장해야 하는 방법을 설명하는 값을 가져오거나 설정합니다.
public:
property Stretch Stretch { Stretch get(); void set(Stretch value); };
Stretch Stretch();
void Stretch(Stretch value);
public Stretch Stretch { get; set; }
var stretch = mediaElement.stretch;
mediaElement.stretch = stretch;
Public Property Stretch As Stretch
<MediaElement Stretch="stretchMemberName" />
속성 값
원본 시각적 미디어가 렌더링되는 방법을 지정하는 Stretch 열거형의 값입니다. 기본값은 Uniform입니다.
예제
다음은 JavaScript를 사용하여 Windows 앱의 msZoom 과 유사하게 확대/축소 효과를 만드는 방법을 보여 주는 몇 가지 코드입니다. MediaElement 콘텐츠는 콘텐츠의 가로 세로 비율을 유지하면서 전체 레이아웃 공간을 채웁니다. 콘텐츠의 가로 세로 비율이 레이아웃 공간과 같지 않으면 자르기 발생합니다.
private void ToggleZoom(MediaElement media)
{
if (media.Stretch != Stretch.UniformToFill)
{
// zoom
media.Stretch = Stretch.UniformToFill;
}
else
{
// unzoom
media.Stretch = Stretch.Uniform;
}
}
설명
MediaElement 콘텐츠에 대한 Stretch 값은 다음과 같습니다.
- 없음: 콘텐츠의 원래 크기가 유지됩니다.
- 채우기: 대상 차원을 채우도록 콘텐츠 크기가 조정됩니다. 비디오의 가로 세로 비율은 유지되지 않습니다.
- UniformToFill: 콘텐츠의 가로 세로 비율을 유지하면서 사용 가능한 레이아웃 공간을 채우기 위해 MediaElement 를 균일하게 확장합니다. 대상 사각형의 가로 세로 비율이 원본과 다른 경우 원본 콘텐츠가 대상 차원에 맞게 잘립니다.
- 균일: MediaElement 를 균일하게 확장하여 이미지의 가로 세로 비율을 유지하면서 레이아웃 공간을 채웁니다. 이렇게 하면 전체 이미지가 표시되고, 왜곡되지 않고, 잘리지 않습니다. 이로 인해 콘텐츠의 가로 세로 비율에 따라 이미지의 위쪽 또는 측면에 레터박싱 또는 필라박싱이 발생할 수 있습니다.