Image.Stretch 屬性

定義

命名空間:

Microsoft.UI.Xaml.Controls

取得或設定值，這個值描述如何延展 影像 以填滿目的矩形。

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 列舉的值，指定未明確指定影像的高度和/或 Width 時，來源影像的呈現方式。 預設值為 Uniform。

備註

只有在 Image 實例尚未針對 Height 和/或 Width 屬性使用明確設定值，而且 Image 實例位於可延展影像的容器內以填滿配置中的一些可用空間時，Stretch 屬性的值才會相關。 如果您將 Stretch 屬性的值設定為 None，則影像一律會保留其自然大小，即使有可能延展它的版面配置容器也一樣。 如需影像大小調整的詳細資訊，請參閱 影像中的。

影像來源和縮放

您應該以數個建議的大小建立您的映射來源，以確保當 Windows 因為裝置縮放和解析度而調整它時，您的應用程式看起來很棒。 這通常是處理影像重設大小，而不是套用非預設 Stretch 值的最佳方式。 為 Image 指定 Source 時，您可以使用命名慣例來根據目前的縮放情形，自動參考正確的資源。 如需命名慣例的詳細資訊和詳細資訊，請參閱 載入針對規模量身打造的影像和資產。

注意

[無] 的 Stretch 值不適用於要支援縮放的影像資源。 系統會偵測調整，並在套用 None 值所隱含的版面配置決策之前載入適當的調整資源。