TimelineMarkerCollection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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. |