TimelineMarkerCollection.Append(TimelineMarker) Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Media

Aggiunge un nuovo elemento alla raccolta.

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)

Parametri

value

TimelineMarker

Nuovo elemento da aggiungere.

Implementazioni

Append(T)

Commenti

API raccolta per TimelineMarkerCollection

TimelineMarkerCollection è un elenco ordinato in cui l'ordine è determinato dal valore Time di ogni elemento TimelineMarker contenuto nell'insieme. L'API raccolta per TimelineMarkerCollection elabora internamente ogni nuovo elemento aggiunto alla raccolta e lo aggiunge in un percorso di indice corrispondente a un ordine aggiornato di tutti i valori Time per tutti gli elementi TimelineMarker dell'insieme.

L'intenzione di avere timelineMarkerCollection mantiene sempre un ordine basato sul tempo è in modo che l'enumerazione/iterazione della raccolta restituisca i valori TimelineMarker nell'ordine che corrisponde alla posizione di un asset multimediale che viene riprodotto e l'ordine in cui gli eventi MarkerReached verranno generati. In caso contrario, se la raccolta non era ordinata, sarebbe stato necessario ordinare la raccolta in base al tempo prima dell'uso.

Se si chiama Accodamento, l'elemento potrebbe essere aggiunto all'inizio, al centro o alla fine dell'elenco ordinato, a seconda del valore Time del TimelineMarker che si sta aggiungendo. Questo comportamento è diverso da quello tipico di Accodamento che estende l'indice e aggiunge sempre all'ultimo indice.

I valori di ora non sono esclusivi in un oggetto TimelineMarkerCollection, più di un TimeMarker con un time condiviso possono trovarsi in un elenco e saranno in ordine basato sul tempo appropriato. Tuttavia, l'ordine relativo tra gli elementi che condividono un time è indeterminato all'interno della raccolta e deve essere considerato un dettaglio dell'implementazione.