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 纳秒。 如果打算以 hours：minutes：seconds 格式显示 Position 值，则必须编写自己的逻辑，以便从 持续时间 单位转换为该格式。

如果不确定加载为 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