Image.Stretch 屬性

定義

命名空間:

Windows.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

如果未明確指定影像的Height和/或Width，則為Stretch列舉值，指定來源影像的呈現方式。 預設值為 Uniform。

備註

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

影像來源和縮放

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

如需如何設計調整的詳細資訊，請參閱 Windows 應用程式設計簡介。

注意

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