TimelineMarkerCollection.Append(TimelineMarker) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Auflistung ein neues Element hinzu.
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)Parameter
- value
- TimelineMarker
Das neue Element, das hinzugefügt werden soll.
Implementiert
Hinweise
Sammlungs-API für TimelineMarkerCollection
Eine TimelineMarkerCollection ist eine sortierte Liste, in der die Reihenfolge durch den Time-Wert jedes in der Auflistung enthaltenen TimelineMarker-Elements bestimmt wird. Die Auflistungs-API für TimelineMarkerCollection verarbeitet intern jedes neue Element, das der Auflistung hinzugefügt wird, und fügt es an einem Indexspeicherort hinzu, der einer aktualisierten Reihenfolge aller Time-Werte für alle TimelineMarker-Elemente in der Auflistung entspricht.
Die Absicht, dass TimelineMarkerCollection immer eine zeitbasierte Reihenfolge beibehält, sodass das Aufzählen/Durchlaufen der Auflistung die TimelineMarker-Werte in der Reihenfolge ergibt, die der Position eines wiedergegebenen Medienobjekts und der Reihenfolge entspricht, in der MarkerReached-Ereignisse ausgelöst würden. Andernfalls wäre es erforderlich gewesen, die Auflistung vor der Verwendung nach Zeit zu sortieren, wenn die Auflistung nicht zeitgeordnet war.
Wenn Sie Append aufrufen, wird das Element möglicherweise dem Anfang, der Mitte oder dem Ende der sortierten Liste hinzugefügt, abhängig vom Zeitwert des TimelineMarkers , den Sie hinzufügen. Dies unterscheidet sich vom typischen Anfügeverhalten , das den Index erweitert und immer dem letzten Index hinzufügt.
Zeitwerte sind in einer TimelineMarkerCollection nicht exklusiv. Mehrere TimelineMarker mit einer freigegebenen Zeit können sich in einer Liste befinden und befinden sich in der entsprechenden zeitbasierten Reihenfolge. Die relative Reihenfolge zwischen Elementen, die eine Zeit gemeinsam nutzen, ist jedoch innerhalb der Auflistung unbestimmt und sollte als Implementierungsdetails betrachtet werden.