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

イメージの Height または Width が明示的に指定されていない場合に、ソース イメージのレンダリング方法を指定する Stretch 列挙の値。 既定値は Uniform です。

注釈

Stretch プロパティの値は、 Image インスタンスが Height プロパティまたは Width プロパティに明示的に設定された値をまだ使用していない場合、および Image インスタンスがイメージをストレッチしてレイアウト内の使用可能なスペースを埋めることができるコンテナー内にある場合にのみ関連します。 Stretch プロパティの値を None に設定した場合、それ以外の場合はストレッチするレイアウト コンテナーがある場合でも、イメージは常に自然なサイズを保持します。 イメージのサイズ設定の詳細については、「 イメージの解説」を参照してください。

画像ソースとスケーリング

デバイスのスケーリングと解像度のために Windows がスケーリングするときにアプリが適切に表示されるように、いくつかの推奨サイズでイメージ ソースを作成する必要があります。 これは多くの場合、既定以外の Stretch 値を適用するのではなく、画像のサイズ変更を処理する場合に適した方法です。 Image の Source を指定する際には、現在のスケーリングに対応したリソースを自動的に示す名前付け規則を利用できます。 名前付け規則の詳細と詳細については、「 スケールに合わせて調整されたイメージと資産を読み込む」を参照してください。

注意

Stretch 値 None は、スケーリングをサポートすることを目的としたイメージ リソースでは機能しません。 スケーリングが検出され、適切なスケーリングされたリソースが読み込まれると、 None 値によって暗黙的に示されるレイアウトの決定が適用されます。