TimelineMarkerCollection.Append(TimelineMarker) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

將新項目加入至集合中。

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)

要加入的新專案。

Append(T)

TimelineMarkerCollection是已排序的清單，其順序是由集合中每個TimelineMarker專案的時間值所決定。 TimelineMarkerCollection的集合 API 會在內部處理新增至集合的每個新專案，並將它新增至索引位置，以對應至集合中所有TimelineMarker專案之所有Time值的更新順序。

讓TimelineMarkerCollection一律維持以時間為基礎的順序，因此列舉/逐一查看集合會依對應到所播放之媒體資產的 Position順序，以及MarkerReached事件引發的順序，提供TimelineMarker值。否則，如果集合不是時間排序，則必須先依使用前的時間排序集合。

如果您呼叫 Append，可能會根據您要新增之TimelineMarker 的 Time 值，將專案新增至已排序清單的開頭、中間或結尾。這與擴充索引且一律新增至最後一個索引的 一般 Append 行為不同。

時間值不在TimelineMarkerCollection中，具有共用時間的一個以上的TimelineMarker可以位於清單中，而且會以適當的時間為基礎。不過，共用時間的專案之間的相對順序在集合內不定，而且應該視為實作詳細資料。