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 以填充可用的布局空间，同时保留内容的纵横比。 如果目标矩形的纵横比与源不同，则剪裁源内容以适应目标尺寸。
• Uniform：均匀拉伸 MediaElement 以填充布局空间，同时保留图像的纵横比。 这将确保显示整个图像，不进行剪切和裁剪。 这可能会导致图像顶部或两侧出现写字框或柱形框，具体取决于内容的纵横比。

另请参阅

• Stretch
• NaturalVideoHeight
• NaturalVideoWidth