TimelineMarkerCollection-Klasse
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern

TimelineMarkerCollection Class

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

Vererbung

Object
  TimelineMarkerCollection

Syntax


public sealed class TimelineMarkerCollection : IList<TimelineMarker>,
    IEnumerable<TimelineMarker>

Attribute

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Member

TimelineMarkerCollectionKlasse hat diese Membertypen:

Konstruktoren

TimelineMarkerCollectionKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
TimelineMarkerCollection Initializes a new instance of the TimelineMarkerCollection class.

 

Methoden

The TimelineMarkerCollection Klasse hat diese Methoden. Es erbt auch Methoden von Object Klasse.

MethodeBeschreibung
Add [C#, VB]Adds a new item to the collection.
Append [C++]Adds a new item to the collection.
Clear Removes all items from the collection.
Contains [C#, VB]Determines whether an element is in the collection.
CopyTo [C#, VB]Copies the elements of the collection to an array, starting at a particular array index.
First [C++]Returns an iterator for the items in the collection.
GetAt [C++]Returns the item located at the specified index.
GetMany [C++]Retrieves multiple elements in a single pass through the iterator.
GetView [C++]Gets an immutable view into the collection.
IndexOf [C++]Retrieves the index of the specified item.
IndexOf [C#, VB]Determines the index of a specific item in the collection.
Insert [C#, VB]Inserts an item into the collection.
InsertAt [C++]Inserts the specified item.
Remove [C#, VB]Removes the first occurrence of a specific object from the collection.
RemoveAt [C++]Removes the item at the specified index.
RemoveAt [C#, VB]Removes the element at the specified index of the collection.
RemoveAtEnd [C++]Removes the last item in the collection.
ReplaceAll [C++]Initially clears the collection, then inserts the provided array as new items.
SetAt [C++]Sets the value at the specified index to the TimelineMarker value specified.

 

Eigenschaften

Der TimelineMarkerCollectionKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

Count [C#, VB]

SchreibgeschütztGets the number of elements contained in the collection.

IsReadOnly [C#, VB]

SchreibgeschütztGets a value indicating whether the collection is read-only.

Item [C#, VB]

Lese-/SchreibzugriffGets or sets the element at the specified index.

Size [C++]

SchreibgeschütztGets the size (count) of the collection.

 

Hinweise

Auflistungs-API für TimelineMarkerCollection

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

Die TimelineMarkerCollection behält immer die Time-basierte Reihenfolge bei, damit das Enumerieren/Durchlaufen der Auflistung die TimelineMarker-Werte in der Reihenfolge ausgibt, die der Position der wiedergegebenen Medien und der Reihenfolge entspricht, in der MarkerReached-Ereignisse ausgelöst werden. Wenn andernfalls die Auflistung nicht Time-sortiert ist, muss die Auflistung vor der Verwendung nach Zeit sortiert werden.

  • Wenn Sie Add (oder Append in C++) aufrufen, wird das Element am Beginn, in der Mitte oder am Ende der sortierten Liste hinzugefügt, je nach dem Time-Wert des hinzugefügten TimelineMarker.
  • Wenn Sie Insert aufrufen (oder InsertAt in C++) wird der index-Parameter ignoriert. Das TimelineMarker-Element wird an einer Indexposition hinzugefügt, die die Reihenfolge der Auflistung durch Time-Werte beibehält. Im Allgemeinen verhält sich Insert identisch mit Add.
  • Wenn Sie mit dem Item-Indexer (GetAt in C++) einen Wert lesen, ist der Index davon abhängig, wie das Element von der internen Logik hinzugefügt wurde. Aber, da Sie diese Logik nicht direkt gesteuert haben, ist es normalerweise besser, Contains (IndexOf für C++) zu verwenden, um bestimmte TimelineMarker in der sortierten Liste zu suchen.
  • Wenn Sie mit dem Item-Indexer (SetAt in C++) einen Wert festlegen, löschen Sie den Wert, der zuvor durch diesen Index bezeichnet wurde. Da sich die Auflistung aber anschließend selbst so reorganisiert, dass die Time-Wertreihenfolge erhalten bleibt, befindet sich der hinzugefügte TimelineMarker anschließend möglicherweise nicht an dem Index, den Sie zugeordnet haben. Vermutlich ist dies nicht ratsam, da Sie nicht sicher sein können, welches Element gelöscht wird. Es wird nicht empfohlen, den Indexer zum Festlegen von Werten zu verwenden.
  • RemoveAt entfernt das indizierte angegebene Element, entfernt jedoch keine doppelten Elemente, wenn der Auflistungsindex für die übrigen Time-Werte verschoben wird. Von der Verwendung von RemoveAt wird abgeraten.

Enumerieren der Auflistung in C# oder Microsoft Visual Basic

Eine TimelineMarkerCollection ist aufzählbar, sodass Sie eine sprachspezifische Syntax wie foreach in C# verwenden können, um die Elemente in der Auflistung aufzuzählen. Der Compiler führt die Typkonvertierung für Sie durch, und Sie müssen nicht explizit in IEnumerable<TimelineMarker> umwandeln. Wenn Sie explizit umwandeln müssen, wenn Sie beispielsweise GetEnumerator aufrufen möchten, wandeln Sie um zu IEnumerable<T> mit einer TimelineMarker-Einschränkung.

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.UI.Xaml.Media
Windows::UI::Xaml::Media [C++]

Metadaten

Windows.winmd

Siehe auch

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

 

 

Anzeigen:
© 2017 Microsoft