MediaElement.Stretch 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

대상 사각형을 채우기 위해 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

원본 시각적 미디어가 렌더링되는 방법을 지정하는 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 를 균일하게 확장하여 이미지의 가로 세로 비율을 유지하면서 레이아웃 공간을 채웁니다. 이렇게 하면 전체 이미지가 표시되고, 왜곡되지 않고, 잘리지 않습니다. 이로 인해 콘텐츠의 가로 세로 비율에 따라 이미지의 위쪽 또는 측면에 레터박싱 또는 필라박싱이 발생할 수 있습니다.

추가 정보

• Stretch
• NaturalVideoHeight
• NaturalVideoWidth