TimelineMarkerCollection.Append(TimelineMarker) Método

Definição

Namespace:

Windows.UI.Xaml.Media

Adiciona um novo item à coleção.

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)

Parâmetros

value

TimelineMarker

O novo item a ser adicionado.

Implementações

Append(T)

Comentários

API de coleção para TimelineMarkerCollection

TimelineMarkerCollection é uma lista ordenada em que a ordem é determinada pelo valor Time de cada item TimelineMarker contido na coleção. A API de coleção para TimelineMarkerCollection processa internamente cada novo item adicionado à coleção e a adiciona em um local de índice que corresponde a uma ordenação atualizada de todos os valores time para todos os itens TimelineMarker na coleção.

A intenção de fazer com que TimelineMarkerCollection sempre mantenha uma ordem baseada em tempo é para que a enumeração/iteração da coleção forneça os valores timelineMarker na ordem que corresponde à posição de um ativo de mídia que está sendo reproduzido e à ordem em que os eventos MarkerReached seriam acionados. Caso contrário, se a coleção não fosse ordenada por tempo, teria sido necessário classificar a coleção por tempo antes de usar.

Se você chamar Append, o item poderá ser adicionado ao início, ao meio ou ao final da lista ordenada, dependendo do valor Time do TimelineMarker que você está adicionando. Isso é diferente do comportamento de Acréscimo típico que estende o índice e sempre adiciona ao último índice.

Os valores de tempo não são exclusivos em uma TimelineMarkerCollection, mais de um TimelineMarker com um Time compartilhado pode estar em uma lista e estará em ordem baseada em tempo apropriada. No entanto, a ordem relativa entre os itens que compartilham um Time é indeterminada dentro da coleção e deve ser considerada um detalhe de implementação.