Image.Stretch Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Ottiene o imposta un valore che descrive il modo in cui un'immagine deve essere estesa per riempire il rettangolo di destinazione.

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"/>

Valore della proprietà

Stretch

Valore dell'enumerazione Stretch che specifica come viene eseguito il rendering dell'immagine di origine, se l'altezza e/o la larghezza dell'immagine non sono specificate in modo esplicito. Il valore predefinito è Uniform.

Commenti

Il valore della proprietà Stretch è rilevante solo se l'istanza di Image non usa già valori impostati in modo esplicito per la proprietà Height e/o Width e se l'istanza di Image si trova all'interno di un contenitore che può estendere l'immagine per riempire uno spazio disponibile nel layout. Se si imposta il valore della proprietà Stretch su Nessuno, l'immagine mantiene sempre le dimensioni naturali, anche se esiste un contenitore di layout che potrebbe estenderlo in caso contrario. Per altre informazioni sul ridimensionamento delle immagini, vedere Osservazioni in Immagine.

Origini delle immagini e ridimensionamento

È consigliabile creare le origini immagini in diverse dimensioni consigliate, per assicurarsi che l'app sia ottimale quando viene ridimensionata da Windows a causa del ridimensionamento e della risoluzione dei dispositivi. Questo è spesso un modo migliore per gestire il ridimensionamento delle immagini anziché applicare un valore Stretch non definito. Quando specifichi un oggetto Source per un oggetto Image, puoi usare una convenzione di denominazione che fa automaticamente riferimento alla risorsa corretta con la scala corretta. Per informazioni specifiche sulla convenzione di denominazione e altre informazioni, vedere Caricare immagini e asset personalizzati per la scalabilità.

Nota

Un valore Stretch di None non funziona per le risorse di immagine destinate a supportare il ridimensionamento. Il ridimensionamento verrà rilevato e la risorsa con scalabilità appropriata viene caricata prima che vengano applicate le decisioni di layout implicite dal valore None .