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;
    }
}

備註

以下是 Stretch 值代表 MediaElement 內容的內容：

• 無：保留內容的原始大小。
• 填滿：內容會調整大小以填滿目的地維度。 不會保留視訊的外觀比例。
• UniformToFill：統一延展 MediaElement 以填滿可用的版面配置空間，同時保留內容的外觀比例。 如果目的矩形的外觀比例與來源不同，則會裁剪來源內容以符合目的地維度。
• 統一：統一延展 MediaElement 以填滿版面配置空間，同時保留影像的外觀比例。 這可確保顯示整個影像、未分割且不會裁剪。 這可能會根據內容的外觀比例，在影像的頂端或側邊產生信箱或柱子。

另請參閱

• Stretch
• NaturalVideoHeight
• NaturalVideoWidth