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)參數
- value
- TimelineMarker
要加入的新專案。
實作
備註
TimelineMarkerCollection的集合 API
TimelineMarkerCollection是已排序的清單，其順序是由集合中每個TimelineMarker專案的時間值所決定。 TimelineMarkerCollection的集合 API 會在內部處理新增至集合的每個新專案，並將它新增至索引位置，以對應至集合中所有TimelineMarker專案之所有Time值的更新順序。
讓TimelineMarkerCollection一律維持以時間為基礎的順序，因此列舉/逐一查看集合會依對應到所播放之媒體資產的 Position順序，以及MarkerReached事件引發的順序，提供TimelineMarker值。 否則，如果集合不是 時間排序，則必須先依使用前的時間排序集合。
如果您呼叫 Append，可能會根據您要新增之TimelineMarker 的 Time值，將專案新增至已排序清單的開頭、中間或結尾。 這與擴充索引且一律新增至最後一個索引的 一般 Append 行為不同。
時間值不在TimelineMarkerCollection中，具有共用時間的一個以上的TimelineMarker可以位於清單中，而且會以適當的時間為基礎。 不過，共用 時間 的專案之間的相對順序在集合內不定，而且應該視為實作詳細資料。