Image.Stretch 属性

定义

命名空间:

Windows.UI.Xaml.Controls

获取或设置一个值，该值描述应如何拉伸 Image 以填充目标矩形。

public:
 property Stretch Stretch { Stretch get(); void set(Stretch value); };

Stretch Stretch();

void Stretch(Stretch value);

public Stretch Stretch { get; set; }

var stretch = image.stretch;
image.stretch = stretch;

Public Property Stretch As Stretch

<Image Stretch="stretchValue"/>

属性值

Stretch

Stretch 枚举的一个值，该值指定如果未显式指定图像的 Height 和/或 Width，则如何呈现源图像。 默认值为 Uniform。

注解

仅当 Image 实例尚未使用 Height 和/ 或 Width 属性的显式设置值，并且 Image 实例位于可以拉伸图像以填充布局中某些可用空间的容器内时，Stretch 属性的值才相关。 如果将 Stretch 属性的值设置为 None，则图像将始终保留其自然大小，即使有布局容器可能会拉伸它，否则也是如此。 有关图像大小调整的详细信息，请参阅 图像中的备注。

图像源和缩放

你应该以多种建议的大小创建图像源，以确保当 Windows 由于设备缩放和分辨率而缩放应用时，应用看起来非常出色。 这通常是处理图像大小调整的更好方法，而不是应用非默认 Stretch 值。 指定 Image 的 Source 时，你可以使用将为当前缩放自动引用正确资源的命名约定。 有关命名约定的详细信息和详细信息，请参阅 加载为缩放量身定做的图像和资产。

有关如何针对缩放进行设计的详细信息，请参阅 Windows 应用设计简介。

注意

Stretch 值 None 不适用于旨在支持缩放的图像资源。 在应用 None 值所暗示的布局决策之前，将检测到缩放并加载相应的缩放资源。