TimelineMarkerCollection.Append(TimelineMarker) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.