TimelineMarkerCollection.Append(TimelineMarker) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega un nuevo elemento a la colección.
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
Nuevo elemento que se va a agregar.
Implementaciones
Comentarios
API de recopilación para TimelineMarkerCollection
TimelineMarkerCollection es una lista ordenada donde el orden viene determinado por el valor Time de cada elemento TimelineMarker contenido en la colección. La API de colección para TimelineMarkerCollection procesa internamente cada nuevo elemento que se agrega a la colección y lo agrega en una ubicación de índice que corresponde a una ordenación actualizada de todos los valores time de todos los elementos TimelineMarker de la colección.
La intención de tener timelineMarkerCollection siempre mantiene un orden basado en tiempo es para que la enumeración o iteración de la colección proporcione los valores timelineMarker en el orden que corresponde a la posición de un recurso multimedia que se está reproduciéndose y el orden en que se activarían los eventos MarkerReached . De lo contrario, si la colección no estuviera ordenada por tiempo, habría sido necesario ordenar la colección por tiempo antes de su uso.
Si llamas a Append, es posible que el elemento se agregue al principio, al medio o al final de la lista ordenada, dependiendo del valor Time de TimelineMarker que agregues. Esto es diferente del comportamiento típico de Append que extiende el índice y siempre agrega al último índice.
Los valores de hora no son exclusivos en una timelineMarkerCollection, más de un timelineMarker con una hora compartida puede estar en una lista y estarán en el orden adecuado basado en el tiempo. Sin embargo, el orden relativo entre los elementos que comparten una hora está indeterminado dentro de la colección y debe considerarse un detalle de implementación.