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 항목에 대한 모든 시간 값의 업데이트된 순서에 해당하는 인덱스 위치에 추가합니다.
TimelineMarkerCollection이 항상 시간 기반 순서를 유지하도록 하려면 컬렉션을 열거/반복하면 재생되는 미디어 자산의 위치 및 MarkerReached 이벤트가 발생하는 순서에 해당하는 순서로 TimelineMarker 값이 부여됩니다. 그렇지 않으면 컬렉션이 시간 순서가 지정되지 않은 경우 사용하기 전에 컬렉션을 시간별로 정렬해야 했습니다.
Append를 호출하는 경우 추가하려는 TimelineMarker의 시간 값에 따라 정렬된 목록의 시작, 중간 또는 끝에 항목이 추가될 수 있습니다. 이는 인덱스를 확장하고 항상 마지막 인덱스에 추가하는 일반적인 추가 동작과 다릅니다.
시간 값은 TimelineMarkerCollection에서 배타적이지 않으며, 공유 시간이 있는 두 개 이상의 TimelineMarker가 목록에 있을 수 있으며 적절한 시간 기반 순서가 됩니다. 그러나 Time 을 공유하는 항목 간의 상대 순서는 컬렉션 내에서 확정되지 않으며 구현 세부 정보로 간주되어야 합니다.