TimelineMarkerCollection Classe

Definição

Namespace:

Windows.UI.Xaml.Media

Representa uma coleção de objetos TimelineMarker que podem ser acessados individualmente pelo índice. Uma TimelineMarkerCollection é uma lista ordenada em que a ordem é determinada pelo valor Time de cada item TimelineMarker contido na coleção. Para obter mais informações sobre como isso afeta a API de coleção, consulte Comentários.

public ref class TimelineMarkerCollection sealed : 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.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)

Herança

Object Platform::Object IInspectable TimelineMarkerCollection

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IIterable<T> IEnumerable<T> IIterable<TimelineMarker> IEnumerable<TimelineMarker> IVector<TimelineMarker> IList<TimelineMarker>

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

API de coleção para TimelineMarkerCollection

Uma TimelineMarkerCollection é uma lista ordenada em que a ordem é determinada pelo valor Time de cada item TimelineMarker contido na coleção. A API de coleção para TimelineMarkerCollection processa internamente cada novo item adicionado à coleção e a adiciona em um local de índice que corresponde a uma ordenação atualizada de todos os valores time para todos os itens TimelineMarker na coleção.

A intenção de fazer com que TimelineMarkerCollection sempre mantenha uma ordem baseada em tempo é para que a enumeração/iteração da coleção forneça os valores timelineMarker na ordem que corresponde à Posição de um ativo de mídia que está sendo reproduzido e à ordem em que os eventos MarkerReached seriam acionados. Caso contrário, se a coleção não fosse ordenada por tempo, teria sido necessário classificar a coleção por tempo antes do uso.

• Se você chamar Append (para C++), o item poderá ser adicionado ao início, ao meio ou ao final da lista ordenada, dependendo do valor time do TimelineMarker que você está adicionando.
• Se você chamar InsertAt (para C++), o parâmetro de índice será ignorado. O item TimelineMarker é adicionado em uma posição de índice que mantém a ordem da coleção por valores time .
• Se você usar o método GetAt (para C++) para ler um valor, o índice estará correto, com base em como o item foi adicionado pela lógica interna. Mas como você não controlou diretamente essa lógica, geralmente é uma ideia melhor usar IndexOf (para C++) para encontrar um TimelineMarker específico na lista ordenada.
• Se você usar o método SetAt (para C++) para definir um valor, excluirá um valor que estava anteriormente nesse índice, mas a coleção será reordenado para manter a ordenação do valor Time , portanto, o novo TimelineMarker que você adicionou pode não estar no índice para o qual você estava definindo. Isso provavelmente é uma má ideia, porque você não terá certeza de qual item será excluído. Recomendamos que você não use o indexador para definir valores.
• RemoveAt removerá o item indexado especificado, mas não removerá possíveis itens duplicados quando o índice da coleção mudar para os valores de Tempo restantes. Recomendamos que você não use RemoveAt.

Enumerando a coleção em C# ou Microsoft Visual Basic

Uma TimelineMarkerCollection é enumerável, portanto, você pode usar a sintaxe específica da linguagem, como foreach em C# para enumerar os itens na coleção. O compilador faz a conversão de tipo para você e você não precisará converter IEnumerable<TimelineMarker> explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta para IEnumerable<T> com uma restrição TimelineMarker .

Construtores

TimelineMarkerCollection()

Inicializa uma nova instância da classe TimelineMarkerCollection .

Propriedades

Size	Obtém o tamanho (contagem) da coleção.

Métodos

Append(TimelineMarker)	Adiciona um novo item à coleção.
Clear()	Remove todos os itens da coleção.
First()	Retorna um iterador para os itens na coleção.
GetAt(UInt32)	Retorna o item localizado no índice especificado.
GetMany(UInt32, TimelineMarker[])	Recupera vários elementos em uma única passagem pelo iterador.
GetView()	Obtém uma exibição imutável na coleção.
IndexOf(TimelineMarker, UInt32)	Recupera o índice do item especificado.
InsertAt(UInt32, TimelineMarker)	Insere o item especificado.
RemoveAt(UInt32)	Remove o item no índice especificado.
RemoveAtEnd()	Remove o último item da coleção.
ReplaceAll(TimelineMarker[])	Inicialmente limpa a coleção e insere a matriz fornecida como novos itens.
SetAt(UInt32, TimelineMarker)	Define o valor no índice especificado como o valor TimelineMarker especificado.

Confira também

• IVector<T>
• IIterable<T>
• IList< T>