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
Новый добавляемый элемент.
Реализации
Комментарии
API коллекции для TimelineMarkerCollection
TimelineMarkerCollection — это упорядоченный список, в котором порядок определяется значением Time каждого элемента TimelineMarker, содержащегося в коллекции. API коллекции для TimelineMarkerCollection внутренне обрабатывает каждый новый элемент, добавляемый в коллекцию, и добавляет его в расположение индекса, соответствующее обновленному упорядочению всех значений Time для всех элементов TimelineMarker в коллекции.
Цель всегда поддерживать в TimelineMarkerCollection порядок на основе времени заключается в том, чтобы при перечислении или итерации коллекции возвращались значения TimelineMarker в порядке, соответствующем позиции воспроизводимого ресурса мультимедиа и порядку срабатывания событий MarkerReached . В противном случае, если коллекция не была упорядочена по времени, необходимо было бы отсортировать коллекцию по времени перед использованием.
При вызове метода Append элемент может быть добавлен в начало, середину или конец упорядоченного списка в зависимости от значения time добавляемого объекта TimelineMarker . Это отличается от типичного поведения append , которое расширяет индекс и всегда добавляет к последнему индексу.
Значения времени не являются эксклюзивными в TimelineMarkerCollection. В списке может находиться несколько значений TimelineMarker с общим временем, которые будут находиться в соответствующем порядке, основанном на времени. Однако относительный порядок между элементами, которые совместно используют time , не определен в коллекции и должен рассматриваться как подробности реализации.