MediaElement.Stretch Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft einen Wert ab, der beschreibt, wie ein MediaElement 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 = mediaElement.stretch;
mediaElement.stretch = stretch;

Public Property Stretch As Stretch

<MediaElement Stretch="stretchMemberName" />

Eigenschaftswert

Stretch

Ein Wert der Stretch-Enumeration , der angibt, wie das visuelle Quellmedium gerendert wird. Der Standardwert ist Uniform.

Beispiele

Im Folgenden finden Sie code, der zeigt, wie Sie einen Zoomeffekt ähnlich wie msZoom in Windows-Apps mithilfe von JavaScript erstellen. Der MediaElement-Inhalt füllt den gesamten Layoutbereich aus und behält dabei das Seitenverhältnis des Inhalts bei. Dies kann zu Zuschneiden führen, wenn das Seitenverhältnis des Inhalts nicht mit dem Layoutbereich übereinstimmt.

private void ToggleZoom(MediaElement media)
{
    if (media.Stretch != Stretch.UniformToFill)
    {
        // zoom
        media.Stretch = Stretch.UniformToFill;
    }
    else
    {
        // unzoom
        media.Stretch = Stretch.Uniform;
    }
}

Hinweise

Die Stretch-Werte stellen für MediaElement-Inhalte dar:

• Keine: Die ursprüngliche Größe des Inhalts wird beibehalten.
• Füllung: Die Größe des Inhalts wird geändert, um die Zieldimensionen auszufüllen. Das Seitenverhältnis des Videos wird nicht beibehalten.
• UniformToFill: Dehnt das MediaElement gleichmäßig aus, um den verfügbaren Layoutbereich zu füllen, während das Seitenverhältnis des Inhalts beibehalten wird. Wenn sich das Seitenverhältnis des Zielrechtecks von der Quelle unterscheidet, wird der Quellinhalt an die Zieldimensionen angepasst.
• Uniform: Das MediaElement wird einheitlich gestreckt, um den Layoutbereich auszufüllen, während das Seitenverhältnis des Bilds beibehalten wird. Dadurch wird sichergestellt, dass das gesamte Bild angezeigt, unverfärigt und nicht zugeschnitten wird. Dies kann je nach Seitenverhältnis des Inhalts zu Letterboxing oder Pillarboxing am oberen Rand oder an den Seiten des Bilds führen.

Weitere Informationen

• Stretch
• NaturalVideoHeight
• NaturalVideoWidth