TimelineMarkerCollection Kelas

Definisi

Ruang nama:

Windows.UI.Xaml.Media

Mewakili kumpulan objek TimelineMarker yang dapat diakses secara individual oleh indeks. TimelineMarkerCollection adalah daftar yang diurutkan di mana pesanan ditentukan oleh nilai Waktu setiap item TimelineMarker yang terkandung dalam koleksi. Untuk informasi selengkapnya tentang bagaimana hal ini memengaruhi API pengumpulan, lihat Keterangan.

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)

Warisan

Object Platform::Object IInspectable TimelineMarkerCollection

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

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

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

API Koleksi untuk TimelineMarkerCollection

TimelineMarkerCollection adalah daftar yang diurutkan di mana pesanan ditentukan oleh nilai Waktu setiap item TimelineMarker yang terkandung dalam koleksi. API pengumpulan untuk TimelineMarkerCollection secara internal memproses setiap item baru yang ditambahkan ke koleksi dan menambahkannya di lokasi indeks yang sesuai dengan urutan yang diperbarui dari semua nilai Waktu untuk semua item TimelineMarker dalam koleksi.

Niat agar TimelineMarkerCollection selalu mempertahankan urutan Berbasis waktu adalah agar menghitung/mengulangi koleksi memberikan nilai TimelineMarker dalam urutan yang sesuai dengan Posisi aset media yang sedang diputar dan urutan yang akan diaktifkan oleh peristiwa MarkerReached . Jika tidak, jika koleksi tidak diurutkan waktu, akan diperlukan untuk mengurutkan koleksi menurut waktu sebelum digunakan.

• Jika Anda memanggil Tambahkan (untuk C++), item mungkin ditambahkan ke awal, tengah, atau akhir daftar yang diurutkan, tergantung pada nilai WaktuTimelineMarker yang Anda tambahkan.
• Jika Anda memanggil InsertAt (untuk C++) parameter indeks diabaikan. Item TimelineMarker ditambahkan pada posisi indeks yang mempertahankan urutan koleksi berdasarkan nilai Waktu .
• Jika Anda menggunakan metode GetAt (untuk C++) untuk membaca nilai, indeks sudah benar, berdasarkan bagaimana item ditambahkan oleh logika internal. Tetapi karena Anda tidak secara langsung mengontrol logika tersebut, biasanya lebih baik menggunakan IndexOf (untuk C++) untuk menemukan TimelineMarker tertentu dalam daftar yang diurutkan.
• Jika Anda menggunakan metode SetAt (untuk C++) untuk mengatur nilai, Anda akan menghapus nilai yang sebelumnya ada di indeks tersebut, tetapi koleksi akan menyusun ulang dirinya sendiri untuk mempertahankan urutan nilai Waktu , sehingga TimelineMarker baru yang Anda tambahkan mungkin tidak berada di indeks yang Anda atur. Ini mungkin ide yang buruk, karena Anda tidak akan yakin item mana yang akan dihapus. Kami sarankan Anda tidak menggunakan pengindeks untuk mengatur nilai.
• RemoveAt akan menghapus item terindeks yang ditentukan, tetapi tidak akan menghapus kemungkinan item duplikat saat indeks koleksi bergeser untuk nilai Waktu yang tersisa. Kami sarankan Anda tidak menggunakan RemoveAt.

Menghitung koleksi dalam C# atau Microsoft Visual Basic

TimelineMarkerCollection dapat dijumlahkan, sehingga Anda dapat menggunakan sintaks khusus bahasa seperti foreach dalam C# untuk menghitung item dalam koleksi. Pengkompilasi melakukan pengecoran jenis untuk Anda dan Anda tidak perlu mentransmisian secara IEnumerable<TimelineMarker> eksplisit. Jika Anda perlu mentransmisikan secara eksplisit, misalnya jika Anda ingin memanggil GetEnumerator, transmisikan ke IEnumerable<T> dengan batasan TimelineMarker .

Konstruktor

TimelineMarkerCollection()

Menginisialisasi instans baru kelas TimelineMarkerCollection .

Properti

Size	Mendapatkan ukuran (hitungan) koleksi.

Metode

Append(TimelineMarker)	Menambahkan item baru ke koleksi.
Clear()	Menghapus semua item dari koleksi.
First()	Mengembalikan iterator untuk item dalam koleksi.
GetAt(UInt32)	Mengembalikan item yang terletak di indeks yang ditentukan.
GetMany(UInt32, TimelineMarker[])	Mengambil beberapa elemen dalam satu pass melalui iterator.
GetView()	Mendapatkan tampilan yang tidak dapat diubah ke dalam koleksi.
IndexOf(TimelineMarker, UInt32)	Mengambil indeks item yang ditentukan.
InsertAt(UInt32, TimelineMarker)	Sisipkan item yang ditentukan.
RemoveAt(UInt32)	Menghapus item pada indeks yang ditentukan.
RemoveAtEnd()	Menghapus item terakhir dalam koleksi.
ReplaceAll(TimelineMarker[])	Awalnya menghapus koleksi, lalu menyisipkan array yang disediakan sebagai item baru.
SetAt(UInt32, TimelineMarker)	Mengatur nilai pada indeks yang ditentukan ke nilai TimelineMarker yang ditentukan.

Lihat juga

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