TimelineMarkerCollection Classe

Definizione

Rappresenta una raccolta di oggetti TimelineMarker a cui è possibile accedere singolarmente per indice. TimelineMarkerCollection è un elenco ordinato in cui l'ordine è determinato dal valore Time di ogni elemento TimelineMarker contenuto nell'insieme. Per altre informazioni su come influisce sull'API della raccolta, vedere Osservazioni.

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)
Ereditarietà
Object Platform::Object IInspectable TimelineMarkerCollection
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

API raccolta per TimelineMarkerCollection

TimelineMarkerCollection è un elenco ordinato in cui l'ordine è determinato dal valore Time di ogni elemento TimelineMarker contenuto nell'insieme. L'API raccolta per TimelineMarkerCollection elabora internamente ogni nuovo elemento aggiunto alla raccolta e lo aggiunge in un percorso di indice corrispondente a un ordine aggiornato di tutti i valori Time per tutti gli elementi TimelineMarker dell'insieme.

L'intenzione di avere timelineMarkerCollection mantiene sempre un ordine basato sul tempo è in modo che l'enumerazione/iterazione della raccolta restituisca i valori TimelineMarker nell'ordine che corrisponde alla posizione di un asset multimediale che viene riprodotto e l'ordine in cui gli eventi MarkerReached verranno generati. In caso contrario, se la raccolta non era ordinata, sarebbe stato necessario ordinare la raccolta in base al tempo prima dell'uso.

  • Se si chiama Accodamento (per C++), l'elemento potrebbe essere aggiunto all'inizio, al centro o alla fine dell'elenco ordinato, a seconda del valore Time del TimelineMarker che si sta aggiungendo.
  • Se si chiama InsertAt (per C++) il parametro di indice viene ignorato. L'elemento TimelineMarker viene aggiunto in una posizione di indice che gestisce l'ordine della raccolta in base ai valori Time .
  • Se si usa il metodo GetAt (per C++) per leggere un valore, l'indice è corretto, in base al modo in cui l'elemento è stato aggiunto dalla logica interna. Ma poiché la logica non è stata controllato direttamente, in genere è preferibile usare IndexOf (per C++) per trovare un timelineMarker specifico nell'elenco ordinato.
  • Se si usa il metodo SetAt (per C++) per impostare un valore, si eliminerà un valore precedentemente in corrispondenza di tale indice, ma l'insieme riordina se stesso per mantenere l'ordinamento del valore Time , quindi il nuovo TimelineMarker aggiunto potrebbe non essere in corrispondenza dell'indice impostato su. Questo è probabilmente un'idea errata, perché non sarà sicuro che l'elemento venga eliminato. È consigliabile non usare l'indicizzatore per impostare i valori.
  • RemoveAt rimuoverà l'elemento indicizzato specificato, ma non rimuoverà eventuali elementi duplicati quando l'indice della raccolta passa per i valori Time rimanenti. È consigliabile non usare RemoveAt.

Enumerazione della raccolta in C# o Microsoft Visual Basic

TimelineMarkerCollection è enumerabile, quindi è possibile usare una sintassi specifica del linguaggio, ad esempio foreach in C# per enumerare gli elementi nella raccolta. Il compilatore esegue il cast di tipi per l'utente e non è necessario eseguire il cast IEnumerable<TimelineMarker> in modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast in IEnumerable<T> con un vincolo TimelineMarker .

Costruttori

TimelineMarkerCollection()

Inizializza una nuova istanza della classe TimelineMarkerCollection .

Proprietà

Size

Ottiene le dimensioni (conteggio) dell'insieme.

Metodi

Append(TimelineMarker)

Aggiunge un nuovo elemento alla raccolta.

Clear()

Rimuove tutti gli elementi dalla raccolta.

First()

Restituisce un iteratore per gli elementi della raccolta.

GetAt(UInt32)

Restituisce l'elemento situato nell'indice specificato.

GetMany(UInt32, TimelineMarker[])

Recupera più elementi in un singolo passaggio dell'iteratore.

GetView()

Ottiene una visualizzazione non modificabile nella raccolta.

IndexOf(TimelineMarker, UInt32)

Recupera l'indice dell'elemento specificato.

InsertAt(UInt32, TimelineMarker)

Inserisce l'elemento specificato.

RemoveAt(UInt32)

Rimuove l'elemento all'indice specificato.

RemoveAtEnd()

Rimuove l'ultimo elemento della raccolta.

ReplaceAll(TimelineMarker[])

Inizialmente cancella la raccolta, quindi inserisce la matrice fornita come nuovi elementi.

SetAt(UInt32, TimelineMarker)

Imposta il valore in corrispondenza dell'indice specificato sul valore TimelineMarker specificato.

Si applica a

Vedi anche