TimelineMarkerCollection Clase

Definición

Representa una colección de objetos TimelineMarker a los que se puede acceder individualmente por índice. TimelineMarkerCollection es una lista ordenada en la que el orden viene determinado por el valor time de cada elemento TimelineMarker contenido en la colección. Para obtener más información sobre cómo afecta esto a la API de recopilación, consulta Comentarios.

public ref class TimelineMarkerCollection sealed : IIterable<TimelineMarker ^>, IVector<TimelineMarker ^>
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class TimelineMarkerCollection final : IIterable<TimelineMarker>, IVector<TimelineMarker>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class TimelineMarkerCollection final : IIterable<TimelineMarker>, IVector<TimelineMarker>
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class TimelineMarkerCollection : IEnumerable<TimelineMarker>, IList<TimelineMarker>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class TimelineMarkerCollection : IEnumerable<TimelineMarker>, IList<TimelineMarker>
Public NotInheritable Class TimelineMarkerCollection
Implements IEnumerable(Of TimelineMarker), IList(Of TimelineMarker)
Herencia
Object Platform::Object IInspectable TimelineMarkerCollection
Atributos
Implementaciones

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

API de recopilación para TimelineMarkerCollection

TimelineMarkerCollection es una lista ordenada en la que 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á reproducndo 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 (para C++), es posible que el elemento se agregue al principio, al medio o al final de la lista ordenada, dependiendo del valor Time del TimelineMarker que agregues.
  • Si llama a InsertAt (para C++), se omite el parámetro de índice . El elemento TimelineMarker se agrega en una posición de índice que mantiene el orden de la colección por valores time .
  • Si usa el método GetAt (para C++) para leer un valor, el índice es correcto, en función de cómo la lógica interna agregó el elemento. Pero dado que no controló directamente esa lógica, normalmente es mejor usar IndexOf (para C++) para buscar un timelineMarker específico en la lista ordenada.
  • Si usa el método SetAt (para C++) para establecer un valor, eliminará un valor que se encontraba anteriormente en ese índice, pero la colección se reordenará para mantener el orden de los valores de hora , por lo que es posible que el nuevo timelineMarker que agregó no esté en el índice en el que estaba estableciendo. Esto es probablemente una mala idea, ya que no estará seguro de qué elemento se elimina. Se recomienda no usar el indexador para establecer valores.
  • RemoveAt quitará el elemento indizado especificado, pero no quitará los posibles elementos duplicados cuando cambie el índice de la colección para los valores time restantes. Se recomienda no usar RemoveAt.

Enumeración de la colección en C# o Microsoft Visual Basic

TimelineMarkerCollection es enumerable, por lo que puede usar sintaxis específica del lenguaje, como foreach en C# para enumerar los elementos de la colección. El compilador realiza la conversión de tipos automáticamente y no es necesario convertir a IEnumerable<TimelineMarker> explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta a IEnumerable<T> con una restricción TimelineMarker .

Constructores

TimelineMarkerCollection()

Inicializa una nueva instancia de la clase TimelineMarkerCollection .

Propiedades

Size

Obtiene el tamaño (recuento) de la colección.

Métodos

Append(TimelineMarker)

Agrega un nuevo elemento a la colección.

Clear()

Quita todos los elementos de la colección.

First()

Devuelve un iterador para los elementos de la colección.

GetAt(UInt32)

Devuelve el elemento ubicado en el índice especificado.

GetMany(UInt32, TimelineMarker[])

Recupera varios elementos en un único paso a través del iterador.

GetView()

Obtiene una vista inmutable en la colección.

IndexOf(TimelineMarker, UInt32)

Recupera el índice del elemento especificado.

InsertAt(UInt32, TimelineMarker)

Inserta el elemento especificado.

RemoveAt(UInt32)

Quita el elemento del índice especificado.

RemoveAtEnd()

Quita el último elemento de la colección.

ReplaceAll(TimelineMarker[])

Inicialmente borra la colección y, a continuación, inserta la matriz proporcionada como elementos nuevos.

SetAt(UInt32, TimelineMarker)

Establece el valor en el índice especificado en el valor TimelineMarker especificado.

Se aplica a

Consulte también