Platform::Collections::Map Class

Mewakili peta, yang merupakan kumpulan pasangan kunci-nilai. Menerapkan Windows::Foundation::Collections::IObservableMap untuk membantu pengikatan data XAML.

Sintaks

template <
   typename K,
   typename V,
   typename C = std::less<K>>
ref class Map sealed;

Parameter

K
Jenis kunci dalam pasangan kunci-nilai.

V
Jenis nilai dalam pasangan kunci-nilai.

C
Jenis yang menyediakan objek fungsi yang dapat membandingkan dua nilai elemen sebagai kunci pengurutan untuk menentukan urutan relatifnya di Peta. Secara default, std::less<K>.

__is_valid_winrt_type() Fungsi yang dihasilkan kompilator yang memvalidasi jenis K dan V dan memberikan pesan kesalahan yang mudah diingat jika jenis tidak dapat disimpan di Peta.

Keterangan

Jenis yang diperbolehkan:

• bilangan bulat

• kelas antarmuka^

• kelas ref publik^

• struktur nilai

• kelas enum publik

Peta pada dasarnya adalah pembungkus untuk std::map. Ini adalah implementasi konkret C++ dari jenis Windows::Foundation::Collections::IMap<Windows::Foundation::Collections::IKeyValuePair<K,V>> dan IObservableMap yang diteruskan di seluruh antarmuka Windows Runtime publik. Jika Anda mencoba menggunakan Platform::Collections::Map jenis dalam nilai atau parameter pengembalian publik, kesalahan pengkompilasi C3986 dimunculkan. Anda dapat memperbaiki kesalahan dengan mengubah jenis parameter atau mengembalikan nilai ke Windows::Foundation::Collections::IMap<K,V>.

Untuk informasi selengkapnya, lihat Koleksi.

Anggota

Konstruktor Publik

Nama	Deskripsi
Peta::Peta	Menginisialisasi instans baru kelas Peta.

Metode Publik

Nama	Deskripsi
Peta::Hapus	Menghapus semua pasangan kunci-nilai dari objek Peta saat ini.
Peta::Pertama	Mengembalikan iterator yang menentukan elemen pertama dalam peta.
Peta::GetView	Mengembalikan tampilan baca-saja dari Peta saat ini; yaitu, Platform::Collections::MapView Class.
Peta::HasKey	Menentukan apakah Peta saat ini berisi kunci yang ditentukan.
Peta::Sisipkan	Menambahkan pasangan kunci-nilai yang ditentukan ke objek Peta saat ini.
Peta::Pencarian	Mengambil elemen pada kunci yang ditentukan di objek Peta saat ini.
Peta::Hapus	Menghapus pasangan kunci-nilai yang ditentukan dari objek Peta saat ini.
Peta::Ukuran	Mengembalikan jumlah elemen dalam objek Peta saat ini.

Acara

Nama	Deskripsi
Peristiwa Peta::MapChanged	Terjadi saat Peta berubah.

Hierarki Warisan

Map

Persyaratan

Header: collection.h

Namespace: Platform::Collections

Peta::Hapus Metode

Menghapus semua pasangan kunci-nilai dari objek Peta saat ini.

Sintaks

virtual void Clear();

Peta::Metode Pertama

Mengembalikan iterator yang menentukan elemen pertama di peta, atau nullptr jika peta kosong.

Sintaks

virtual Windows::Foundation::Collections::IIterator<
Windows::Foundation::Collections::IKeyValuePair<K, V>^>^ First();

Tampilkan Nilai

Iterator yang menentukan elemen pertama dalam peta.

Keterangan

Cara mudah untuk menahan iterator yang dikembalikan oleh First() adalah dengan menetapkan nilai pengembalian ke variabel yang dideklarasikan dengan auto kata kunci pengurangan jenis. Contohnya,auto x = myMap->First();.

Peta::Metode GetView

Mengembalikan tampilan baca-saja dari Peta saat ini; yaitu, Platform::Collections::MapView Class, yang mengimplementasikan antarmuka Windows::Foundation::Collections::IMapView<K,V> .

Sintaks

Windows::Foundation::Collections::IMapView<K, V>^ GetView();

Tampilkan Nilai

Objek MapView.

Peta::Metode HasKey

Menentukan apakah Peta saat ini berisi kunci yang ditentukan.

Sintaks

bool HasKey(K key);

Parameter

kunci
Kunci yang digunakan untuk menemukan elemen Peta. Jenis kuncinya adalah typename K.

Tampilkan Nilai

true jika kunci ditemukan; jika tidak, false.

Peta::Sisipkan Metode

Menambahkan pasangan kunci-nilai yang ditentukan ke objek Peta saat ini.

Sintaks

virtual bool Insert(K key, V value);

Parameter

kunci
Bagian kunci dari pasangan kunci-nilai. Jenis kuncinya adalah typename K.

value
Bagian nilai dari pasangan kunci-nilai. Jenis nilainya adalah typename V.

Tampilkan Nilai

true jika kunci elemen yang ada di Peta saat ini cocok dengan kunci dan bagian nilai dari elemen tersebut diatur ke nilai. false jika tidak ada elemen yang ada di Peta saat ini yang cocok dengan kunci dan parameter kunci dan nilai dibuat menjadi pasangan kunci-nilai lalu ditambahkan ke Peta saat ini.

Peta::Metode Pencarian

Mengambil nilai tipe V yang terkait dengan kunci tipe K yang ditentukan, jika kunci ada.

Sintaks

V Lookup(K key);

Parameter

kunci
Kunci yang digunakan untuk menemukan elemen di Peta. Jenis kuncinya adalah typename K.

Tampilkan Nilai

Nilai yang dipasangkan dengan kunci. Jenis nilai yang dikembalikan adalah typename V.

Keterangan

Jika kunci tidak ada, maka Platform::OutOfBoundsException akan dilemparkan.

Peta::Petakan Konstruktor

Menginisialisasi instans baru kelas Peta.

Sintaks

explicit Map(const C& comp = C());
explicit Map(const StdMap& m);
explicit Map(StdMap&& m);
template <typename InIt>
Map(
   InItfirst,
   InItlast,
   const C& comp = C());

Parameter

Init
Nama jenis Peta saat ini.

Comp
Jenis yang menyediakan objek fungsi yang dapat membandingkan dua nilai elemen sebagai kunci pengurutan untuk menentukan urutan relatifnya di Peta.

m
Referensi atau rvalue ke map Class yang digunakan untuk menginisialisasi Peta saat ini.

first
Iterator input elemen pertama dalam berbagai elemen yang digunakan untuk menginisialisasi Peta saat ini.

last
Iterator input elemen pertama setelah rentang elemen yang digunakan untuk menginisialisasi Peta saat ini.

Map::MapChanged Event

Dimunculkan ketika item disisipkan ke dalam atau dihapus dari peta.

Sintaks

event Windows::Foundation::Collections::MapChangedEventHandler<K,V>^ MapChanged;

Nilai Properti/Nilai Pengembalian

MapChangedEventHandler<K,V> yang berisi informasi tentang objek yang meningkatkan peristiwa, dan jenis perubahan yang terjadi. Lihat juga IMapChangedEventArgs<K> dan CollectionChange Enumeration.

.NET Framework Setara

Aplikasi Windows Runtime yang menggunakan proyek C# atau Visual Basic IMap<K,V> sebagai IDictionary<K,V>.

Peta::Hapus Metode

Menghapus pasangan kunci-nilai yang ditentukan dari objek Peta saat ini.

Sintaks

virtual void Remove(K key);

Parameter

kunci
Bagian kunci dari pasangan kunci-nilai. Jenis kuncinya adalah typename K.

Peta::Metode Ukuran

Mengembalikan jumlah elemen Windows::Foundation::Collections::IKeyValuePair<K,V> di Peta.

Sintaks

virtual property unsigned int Size;

Tampilkan Nilai

Jumlah elemen di Peta.

Lihat juga

Koleksi (C++/CX)
Platform Namespace
Membuat Komponen Runtime Windows di C++