MediaElement.Position 屬性

定義

命名空間:

Windows.UI.Xaml.Controls

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

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

屬性值

TimeSpan 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 報告 CanSeek 為 false，在此情況下，您無法使用 Position 來設定播放點。

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

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

XAML 語法注意事項

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

另請參閱

• NaturalDuration