MediaElement.Position Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft die aktuelle Position des Status über die Wiedergabezeit der Medien ab oder legt diese fest.

public:
 property TimeSpan Position { TimeSpan get(); void set(TimeSpan value); };

TimeSpan Position();

void Position(TimeSpan value);

public System.TimeSpan Position { get; set; }

var timeSpan = mediaElement.position;
mediaElement.position = timeSpan;

Public Property Position As TimeSpan

Eigenschaftswert

TimeSpan TimeSpan

Die Zeitspanne seit dem Start des Mediums. Der Standardwert ist eine TimeSpan mit dem Wert "0:0:0".

Hinweise

Legen Sie diese Eigenschaft fest, um eine bestimmte Start-Wiedergabeposition innerhalb des Mediums festzulegen.

Ein TimeSpan wird je nach verwendeter Programmiersprache als unterschiedliche Typen dargestellt.

C# oder Microsoft Visual Basic Verwenden Sie eine System.TimeSpan-Struktur . System.TimeSpan verfügt über Hilfsprogrammmember wie Parse(String), die das Erstellen, Ändern oder Vergleichen von Zeitwerten vereinfachen.

Visual C++-Komponentenerweiterungen (C++/CX) Verwenden Sie eine Windows::Foundation::TimeSpan-Struktur . Diese Struktur verfügt über nur einen Feldmember (Duration), der um 100 Nanosekundeneinheiten misst. Wenn Sie einen Position-Wert in einem Stunden:Minuten:Sekundenformat anzeigen möchten, müssen Sie ihre eigene Logik für die Konvertierung in dieses Format aus den Duration-Einheiten schreiben.

Wenn Sie sich nicht sicher sind, ob die aktuelle Medienquelle als MediaElement.Source geladen wird, überprüfen Sie zuerst CanSeek . Eine Streamingmedienquelle führt dazu , dass MediaElementCanSeek als false meldet, und in diesem Fall können Sie den Wiedergabepunkt nicht mithilfe von Position festlegen.

Wenn Position festgelegt ist, gelten die folgenden Werteinschränkungen:

• Wenn Position auf einen negativen Wert festgelegt ist, wird der Wert in eine TimeSpan mit dem Wert "0:0:0" rückgängig machen.
• Wenn Position auf einen Wert festgelegt ist, der größer als die NaturalDuration des Mediums ist, wird Position zum Wert von NaturalDuration.

Hinweise zur XAML-Syntax

Das Festlegen eines Position-Werts in XAML ist technisch möglich, aber nicht üblich. Wenn Sie eine Position in XAML festlegen, simulieren Sie das Konvertierungsverhalten des Typs "FromString" für einen TimeSpan, d. h. geben Sie den Wert im Format "HH:MM:SS" an.

Weitere Informationen

• NaturalDuration