winrt::observable_map_base templat struct (C++/WinRT))

Kelas dasar tempat Anda dapat memperoleh untuk mengimplementasikan koleksi asosiatif kustom Anda sendiri yang dapat diamati. Untuk informasi selengkapnya, dan contoh kode, lihat Koleksi dengan C++/WinRT.

Sintaks

template <typename D, typename K, typename V>
struct observable_map_base : map_base<D, K, V>

Parameter templat

typename D Nama jenis turunan Anda.

typename K Jenis kunci dalam koleksi.

typename V Jenis nilai dalam koleksi.

Persyaratan

SDK minimum yang didukung: Windows SDK versi 10.0.17763.0 (Windows 10, versi 1809)

Namespace: winrt

Header: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (disertakan secara default)

Fungsi anggota

Fungsi Deskripsi
observable_map_base::Clear function Menghapus semua elemen dari objek observable_map_base .
observable_map_base::Fungsi pertama Mengambil IIterator yang mewakili elemen pertama dalam objek observable_map_base .
observable_map_base::Fungsi GetView Mengambil tampilan objek observable_map_base yang tidak dapat diubah.
observable_map_base::HasKey (Fungsi HasKey) Menentukan apakah kunci yang ditentukan milik elemen dalam objek observable_map_base .
observable_map_base::Sisipkan fungsi Menyisipkan atau memperbarui elemen dalam objek observable_map_base .
observable_map_base::Fungsi pencarian Mencari elemen yang diidentifikasi oleh kunci yang ditentukan, dan mengambil nilai yang sesuai.
observable_map_base::MapChanged (Fungsi observable_map_base::MapChanged) Mendaftarkan dan mencabut delegasi yang menangani peristiwa yang diubah peta dari objek observable_map_base .
observable_map_base::Hapus fungsi Menghapus elemen dari objek observable_map_base .
observable_map_base::Fungsi ukuran Mengambil jumlah elemen dalam objek observable_map_base .

Iterator

observable_map_base adalah rentang, dan rentang tersebut didefinisikan oleh fungsi bebas internal (yang masing-masing mengambil iterator) yang kompatibel dengan fitur bahasa standar. Karena itu, Anda dapat menghitung elemen dalam objek observable_map_base dengan pernyataan berbasis for rentang.

Anda juga dapat mengambil IIterator dari fungsi observable_map_base::First , dan menggunakannya untuk melakukan iterasi melalui elemen dalam objek observable_map_base .

...
#include <iostream>
using namespace winrt;
using namespace Windows::Foundation::Collections;
...
struct MyObservableMap :
    implements<MyObservableMap, IObservableMap<winrt::hstring, int>, IMap<winrt::hstring, int>, IMapView<winrt::hstring, int>, IIterable<IKeyValuePair<winrt::hstring, int>>>,
    winrt::observable_map_base<MyObservableMap, winrt::hstring, int>
{
    auto& get_container() const noexcept
    {
        return m_values;
    }

    auto& get_container() noexcept
    {
        return m_values;
    }

private:
    std::map<winrt::hstring, int> m_values{
        { L"AliceBlue", 0xfff0f8ff }, { L"AntiqueWhite", 0xfffaebd7 }
    };
};
...
IObservableMap<winrt::hstring, int> map{ winrt::make<MyObservableMap>() };

for (auto const& el : map)
{
    std::wcout << el.Key().c_str() << L", " << std::hex << el.Value() << std::endl;
}

IIterator<IKeyValuePair<winrt::hstring, int>> it{ map.First() };
while (it.HasCurrent())
{
    std::wcout << it.Current().Key().c_str() << L", " << std::hex << it.Current().Value() << std::endl;
    it.MoveNext();
}

observable_map_base::Clear function

Menghapus semua elemen dari objek observable_map_base .

Sintaks

void Clear() noexcept;

observable_map_base::Fungsi pertama

Mengambil IIterator yang mewakili elemen pertama dalam objek observable_map_base .

Sintaks

auto First();

Mengembalikan nilai

IIterator yang mewakili elemen pertama dalam objek observable_map_base.

observable_map_base::Fungsi GetView

Mengambil tampilan objek observable_map_base yang tidak dapat diubah.

Sintaks

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

Mengembalikan nilai

IMapView yang berisi tampilan observable_map_base yang tidak dapat diubah.

observable_map_base::HasKey (Fungsi HasKey)

Menentukan apakah kunci yang ditentukan milik elemen dalam objek observable_map_base .

Sintaks

bool HasKey(K const& key) const noexcept;

Parameter

key Kunci yang harus dicari.

Mengembalikan nilai

true jika elemen yang berisi kunci ditemukan, jika tidak false.

observable_map_base::Sisipkan fungsi

Menyisipkan atau memperbarui elemen dalam objek observable_map_base .

Sintaks

bool Insert(K const& key, V const& value);

Parameter

key Kunci yang terkait dengan elemen untuk disisipkan atau diperbarui.

value Nilai yang akan disisipkan atau diganti.

Mengembalikan nilai

true jika elemen dengan kunci yang ditentukan ditemukan dan diperbarui; jika tidak false.

observable_map_base::Fungsi pencarian

Mencari elemen yang diidentifikasi oleh kunci yang ditentukan, dan mengambil nilai yang sesuai.

Sintaks

V Lookup(K const& key) const;

Parameter

key Kunci untuk mencari.

Mengembalikan nilai

Nilai yang sesuai dengan kunci yang sedang dicari jika ditemukan, jika tidak, pengecualian winrt::hresult_out_of_bounds dilemparkan.

observable_vector_base::MapChanged

Mendaftar dan/atau mencabut delegasi yang menangani peristiwa yang diubah peta dari objek observable_map_base .

Sintaks

// Register
winrt::event_token MapChanged(winrt::Windows::Foundation::Collections::MapChangedEventHandler<K, V> const& handler);

// Revoke with event_token
void MapChanged(winrt::event_token const cookie);

// Revoke with event_revoker
MapChanged_revoker MapChanged(winrt::auto_revoke_t, winrt::Windows::Foundation::Collections::MapChangedEventHandler<K, V> const& handler) const

Mengembalikan nilai

Baik void, winrt::event_token yang dapat Anda cabut delegasi terdaftar, atau MapChanged_revoker (alias jenis untuk winrt::event_revoker<IObservableMap<K, V>>) tempat Anda dapat mencabut delegasi terdaftar.

Contoh

winrt::event_revoker<IObservableMap<winrt::hstring, int>> m_event_revoker;
...
m_event_revoker = map.MapChanged(winrt::auto_revoke, [this](IObservableMap<winrt::hstring, int> const&, IMapChangedEventArgs<winrt::hstring> const&)
{
    ...
});

observable_map_base::Hapus fungsi

Menghapus elemen dari objek observable_map_base .

Sintaks

void Remove(K const& key);

Parameter

key Kunci yang terkait dengan elemen yang akan dihapus.

observable_map_base::Fungsi ukuran

Mengambil jumlah elemen dalam objek observable_map_base .

Sintaks

uint32_t Size() const noexcept;

Mengembalikan nilai

Nilai yang menunjukkan jumlah elemen dalam objek observable_map_base .

Lihat juga