TimelineMarkerCollection.Append(TimelineMarker) Méthode

Définition

Espace de noms:

Windows.UI.Xaml.Media

Ajoute un nouvel élément à la collection.

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)

Paramètres

value

TimelineMarker

Nouvel élément à ajouter.

Implémente

Append(T)

Remarques

API de collection pour TimelineMarkerCollection

Une TimelineMarkerCollection est une liste ordonnée où l’ordre est déterminé par la valeur Time de chaque élément TimelineMarker contenu dans la collection. L’API de collection pour TimelineMarkerCollection traite en interne chaque nouvel élément ajouté à la collection et l’ajoute à un emplacement d’index qui correspond à un classement mis à jour de toutes les valeurs Time pour tous les éléments TimelineMarker de la collection.

L’intention d’avoir timelineMarkerCollection toujours maintenir un ordre basé sur l’heure est de sorte que l’énumération/itération de la collection donne les valeurs TimelineMarker dans l’ordre qui correspond à la position d’une ressource multimédia en cours de lecture et à l’ordre dans lequel les événements MarkerReached se déclenchent. Sinon, si la collection n’était pas triée dans le temps, il aurait été nécessaire de trier la collection par heure avant de l’utiliser.

Si vous appelez Append, l’élément peut être ajouté au début, au milieu ou à la fin de la liste triée, en fonction de la valeur Time du TimelineMarker que vous ajoutez. Cela est différent du comportement d’append typique qui étend l’index et ajoute toujours au dernier index.

Les valeurs d’heure ne sont pas exclusives dans une TimelineMarkerCollection. Plusieurs TimelineMarker avec une heure partagée peuvent se trouver dans une liste et seront dans l’ordre horaire approprié. Toutefois, l’ordre relatif entre les éléments qui partagent une heure est indéterminé au sein de la collection et doit être considéré comme un détail d’implémentation.