TimelineMarkerCollection Klasse

Definition

Namespace:

Windows.UI.Xaml.Media

Stellt eine Auflistung von TimelineMarker-Objekten dar, auf die vom Index einzeln zugegriffen werden kann. Eine TimelineMarkerCollection ist eine sortierte Liste, in der die Reihenfolge durch den Time-Wert jedes in der Auflistung enthaltenen TimelineMarker-Elements bestimmt wird. Weitere Informationen dazu, wie sich dies auf die Sammlungs-API auswirkt, finden Sie unter Hinweise.

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)

Vererbung

Object Platform::Object IInspectable TimelineMarkerCollection

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

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

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Sammlungs-API für TimelineMarkerCollection

Eine TimelineMarkerCollection ist eine sortierte Liste, in der die Reihenfolge durch den Time-Wert jedes in der Auflistung enthaltenen TimelineMarker-Elements bestimmt wird. Die Auflistungs-API für TimelineMarkerCollection verarbeitet intern jedes neue Element, das der Auflistung hinzugefügt wird, und fügt es an einem Indexspeicherort hinzu, der einer aktualisierten Reihenfolge aller Time-Werte für alle TimelineMarker-Elemente in der Auflistung entspricht.

Die Absicht, dass TimelineMarkerCollection immer eine zeitbasierte Reihenfolge beibehält, sodass das Aufzählen/Durchlaufen der Auflistung die TimelineMarker-Werte in der Reihenfolge ergibt, die der Position eines wiedergegebenen Medienobjekts und der Reihenfolge entspricht, in der MarkerReached-Ereignisse ausgelöst würden. Andernfalls wäre es erforderlich gewesen, die Auflistung vor der Verwendung nach Zeit zu sortieren, wenn die Auflistung nicht zeitgeordnet war.

• Wenn Sie Append (für C++) aufrufen, wird das Element möglicherweise dem Anfang, der Mitte oder dem Ende der sortierten Liste hinzugefügt, abhängig vom Zeitwert des TimelineMarkers , den Sie hinzufügen.
• Wenn Sie InsertAt (für C++) aufrufen, wird der Indexparameter ignoriert. Das TimelineMarker-Element wird an einer Indexposition hinzugefügt, die die Reihenfolge der Auflistung nach Time-Werten beibehält.
• Wenn Sie die GetAt-Methode (für C++) verwenden, um einen Wert zu lesen, ist der Index richtig, je nachdem, wie das Element von der internen Logik hinzugefügt wurde. Da Sie diese Logik jedoch nicht direkt gesteuert haben, empfiehlt es sich in der Regel, IndexOf (für C++) zu verwenden, um einen bestimmten TimelineMarker in der sortierten Liste zu finden.
• Wenn Sie die SetAt-Methode (für C++) verwenden, um einen Wert festzulegen, löschen Sie einen Wert, der sich zuvor an diesem Index befand, aber die Auflistung wird sich selbst neu anordnen, um die Zeitwertreihenfolge beizubehalten, sodass sich der hinzugefügte neue TimelineMarker möglicherweise nicht am Index befindet, auf den Sie festgelegt haben. Dies ist wahrscheinlich eine schlechte Idee, da Sie nicht sicher sein werden, welches Element gelöscht wird. Es wird empfohlen, den Indexer nicht zum Festlegen von Werten zu verwenden.
• RemoveAt entfernt das angegebene indizierte Element, aber keine möglichen doppelten Elemente, wenn sich der Auflistungsindex für die verbleibenden Zeitwerte verschiebt. Es wird empfohlen, RemoveAt nicht zu verwenden.

Auflisten der Sammlung in C# oder Microsoft Visual Basic

Eine TimelineMarkerCollection ist aufzählbar, sodass Sie sprachspezifische Syntax wie foreach in C# verwenden können, um die Elemente in der Auflistung aufzulisten. Der Compiler führt die Typumwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<TimelineMarker> umgewandelt werden. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie mit einer TimelineMarker-Einschränkung in IEnumerable<T> um.

Konstruktoren

TimelineMarkerCollection()

Initialisiert eine neue instance der TimelineMarkerCollection-Klasse.

Eigenschaften

Size	Ruft die Größe (Anzahl) der Auflistung ab.

Methoden

Append(TimelineMarker)	Fügt der Auflistung ein neues Element hinzu.
Clear()	Entfernt alle Elemente aus der Auflistung.
First()	Gibt einen Iterator für die Elemente in der Auflistung zurück.
GetAt(UInt32)	Gibt das Element zurück, das sich am angegebenen Index befindet.
GetMany(UInt32, TimelineMarker[])	Ruft mehrere Elemente in einem einzelnen Durchgang durch den Iterator ab.
GetView()	Ruft eine unveränderliche Ansicht in die Auflistung ab.
IndexOf(TimelineMarker, UInt32)	Ruft den Index des angegebenen Elements ab.
InsertAt(UInt32, TimelineMarker)	Fügt das angegebene Element ein.
RemoveAt(UInt32)	Entfernt das Element am angegebenen Index.
RemoveAtEnd()	Entfernt das letzte Element in der Auflistung.
ReplaceAll(TimelineMarker[])	Löscht zunächst die Auflistung und fügt dann das bereitgestellte Array als neue Elemente ein.
SetAt(UInt32, TimelineMarker)	Legt den Wert am angegebenen Index auf den angegebenen TimelineMarker-Wert fest.

Weitere Informationen

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