Share via


TimelineMarkerCollection.Append(TimelineMarker) 메서드

정의

컬렉션에 새 항목을 추가합니다.

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 항목에 대한 모든 시간 값의 업데이트된 순서에 해당하는 인덱스 위치에 추가합니다.

TimelineMarkerCollection이 항상 시간 기반 순서를 유지하도록 하려면 컬렉션을 열거/반복하면 재생되는 미디어 자산의 위치MarkerReached 이벤트가 발생하는 순서에 해당하는 순서로 TimelineMarker 값이 부여됩니다. 그렇지 않으면 컬렉션이 시간 순서가 지정되지 않은 경우 사용하기 전에 컬렉션을 시간별로 정렬해야 했습니다.

Append를 호출하는 경우 추가하려는 TimelineMarker시간 값에 따라 정렬된 목록의 시작, 중간 또는 끝에 항목이 추가될 수 있습니다. 이는 인덱스를 확장하고 항상 마지막 인덱스에 추가하는 일반적인 추가 동작과 다릅니다.

시간 값은 TimelineMarkerCollection에서 배타적이지 않으며, 공유 시간이 있는 두 개 이상의 TimelineMarker가 목록에 있을 수 있으며 적절한 시간 기반 순서가 됩니다. 그러나 Time 을 공유하는 항목 간의 상대 순서는 컬렉션 내에서 확정되지 않으며 구현 세부 정보로 간주되어야 합니다.

적용 대상