TimelineMarkerCollection.Append(TimelineMarker) 方法

定义

命名空间:

Windows.UI.Xaml.Media

将新项添加到集合。

public:
 virtual void Append(TimelineMarker ^ value) = IVector<TimelineMarker ^>::Append;

void Append(TimelineMarker const& value);

public void Append(TimelineMarker value);

function append(value)

Public Sub Append (value As TimelineMarker)

参数

value

TimelineMarker

要添加的新项。

实现

Append(T)

注解

TimelineMarkerCollection 的集合 API

TimelineMarkerCollection 是一个有序列表，其中的顺序由集合中包含的每个 TimelineMarker 项的 Time 值确定。 TimelineMarkerCollection 的集合 API 在内部处理添加到集合中的每个新项，并将其添加到索引位置，该索引位置对应于集合中所有 TimelineMarker 项的所有 Time 值的更新顺序。

让 TimelineMarkerCollection 始终维护基于时间的顺序的目的是使枚举/循环访问集合会根据与正在播放的媒体资产的位置以及 MarkerReached 事件触发的顺序相对应的顺序提供 TimelineMarker 值。 否则，如果集合不是 按时间排序的，则需要在使用前按时间对集合进行排序。

如果调用 Append，则项目可能会添加到排序列表的开头、中间或末尾，具体取决于要添加的 TimelineMarker的时间值。 这与扩展索引并始终添加到最后一个索引的典型 Append 行为不同。

时间值在 TimelineMarkerCollection 中并不独占，具有共享时间的多个 TimelineMarker 可以位于列表中，并且将采用适当的基于时间的顺序。 但是，共享 Time 的项之间的相对顺序在集合中是不确定的，应被视为实现详细信息。