共用方式為


MediaElement.Position 屬性

定義

取得或設定媒體播放時間進度的目前位置。

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

屬性值

自媒體開始播放後的時間量。 預設值是值為 「0:0:0」 的 TimeSpan

備註

將此屬性設定為在媒體內設定特定的開始播放位置。

TimeSpan會根據您使用的程式設計語言,以不同的類型表示。

C# 或 Microsoft Visual Basic 使用 System.TimeSpan 結構。 System.TimeSpan 具有公用程式成員,例如 Parse (String) ,可讓您輕鬆地建立、變更或比較時間值。

Visual C++ 元件延伸模組 (C++/CX) 使用 Windows::Foundation::TimeSpan 結構。 這個結構只有一個欄位成員 (Duration) ,以 100 奈秒為單位來測量。 如果您想要以小時:分鐘:秒格式顯示 Position 值,您必須撰寫自己的邏輯,以從 Duration 單位轉換成該格式。

如果您不確定目前載入為 MediaElement.Source的媒體來源,請一律先檢查 CanSeek 。 串流媒體來源會導致 MediaElement 報告 CanSeekfalse,在此情況下,您無法使用 Position 來設定播放點。

如果 Position 是可設定的,則這些值條件約束會套用:

  • 如果 Position 設定為負值,此值會還原為值為 「0:0:0」 的 TimeSpan
  • 如果 Position 設定為大於媒體 的 NaturalDuration的值,則 Position 會變成 NaturalDuration的值。

XAML 語法注意事項

在 XAML 中設定 Position 值是技術上可行的,但並非常見。 如果您在 XAML 中設定 Position,請模擬 TimeSpan的 「FromString」 類型轉換行為,換句話說,請以 「HH:MM:SS」 格式指定值。

適用於

另請參閱