Image.Stretch Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft einen Wert ab, der beschreibt, wie ein Bild gestreckt werden soll, um das Zielrechteck auszufüllen, oder legt diesen fest.

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

Eigenschaftswert

Stretch

Ein Wert der Stretch-Enumeration , der angibt, wie das Quellbild gerendert wird, wenn die Höhe und/oder Breite des Bilds nicht explizit angegeben sind. Der Standardwert ist Uniform.

Hinweise

Der Wert der Stretch-Eigenschaft ist nur relevant, wenn der Image-instance nicht bereits explizit festgelegte Werte für die Height- und/oder Width-Eigenschaft verwendet, und wenn sich der Image-instance in einem Container befindet, der das Bild strecken kann, um einen verfügbaren Platz im Layout auszufüllen. Wenn Sie den Wert der Stretch-Eigenschaft auf None festlegen, behält das Bild immer seine natürliche Größe bei, auch wenn ein Layoutcontainer vorhanden ist, der es andernfalls strecken könnte. Weitere Informationen zur Größenanpassung von Bildern finden Sie unter Hinweise in Image.

Bildquellen und Skalierung

Sie sollten Ihre Bildquellen in mehreren empfohlenen Größen erstellen, um sicherzustellen, dass Ihre App aufgrund der Geräteskalierung und -auflösung von Windows skaliert wird. Dies ist häufig eine bessere Möglichkeit, die Bildgröße zu ändern, anstatt einen nicht standardmäßigen Stretch-Wert anzuwenden. Beim Angeben von Source für Image können Sie eine Benennungskonvention verwenden, die automatisch auf die richtige Ressource für die aktuelle Skalierung verweist. Einzelheiten zur Benennungskonvention und weitere Informationen finden Sie unter Laden von Bildern und Ressourcen, die auf die Skalierung zugeschnitten sind.

Weitere Informationen zum Entwerfen für die Skalierung finden Sie unter Einführung in das Design von Windows-Apps.

Hinweis

Der Stretch-Wert None funktioniert nicht für Bildressourcen, die die Skalierung unterstützen sollen. Die Skalierung wird erkannt, und die entsprechende skalierte Ressource wird geladen, bevor die Layoutentscheidungen angewendet werden, die durch den Wert None impliziert werden.