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 項目の Time 値によって順序が決定される順序付きリストです。 TimelineMarkerCollection のコレクション API は、コレクションに追加された新しい各項目を内部的に処理し、コレクション内のすべての TimelineMarker 項目のすべての Time 値の更新順序に対応するインデックス位置に追加します。
TimelineMarkerCollection で常に時間ベースの順序を維持する目的は、コレクションを列挙または反復処理すると、再生されているメディアアセットの Position と MarkerReached イベントが発生する順序に対応する順序で TimelineMarker 値が与えられるということです。 それ以外の場合、コレクションが 時間順でない場合は、使用する前に時間順にコレクションを並べ替える必要がありました。
Append を呼び出すと、追加する TimelineMarker の Time 値に応じて、順序付けされたリストの先頭、中央、または末尾に項目が追加される場合があります。 これは、インデックスを拡張し、常に最後のインデックスに追加する一般的な Append 動作とは異なります。
Time 値は TimelineMarkerCollection 内で排他的ではありません。共有時間を持つ複数の TimelineMarker をリストに含め、適切な時間ベースの順序になります。 ただし、 Time を共有する項目間の相対順序はコレクション内で不確定であり、実装の詳細と見なす必要があります。