winrt：：map_view_base結構範本 (C++/WinRT)

發行項
07/20/2023

基類，您可以從中衍生來實作自己的自訂檢視或範圍，以實作關聯集合中連續專案序列。如需詳細資訊和程式碼範例，請參閱使用 C++/WinRT 的集合。

語法

template <typename D, typename K, typename V, typename Version = winrt::impl::no_collection_version>
struct map_view_base : iterable_base<D, winrt::Windows::Foundation::Collections::IKeyValuePair<K, V>, Version>

範本參數

typename D 您的衍生類型名稱。

typename K集合中map_view_base檢視或跨越的索引鍵類型。

typename V集合中map_view_base檢視或跨越的數值型別。

typename Version 類型，提供集合的版本設定原則和服務。

規格需求

最低支援的 SDK：Windows SDK 10.0.17763.0 版 (Windows 10 版本 1809)

命名空間： winrt

標頭： %WindowsSdkDir%IncludeWindowsTargetPlatformVersion <> \cppwinrt\winrt\base. (h 預設包含)

成員函數

函式	描述
map_view_base：：First 函式	擷取 IIterator ，代表 map_view_base 物件檢視的第一個專案。
map_view_base：：HasKey 函式	判斷指定的索引鍵是否屬於由 map_view_base 物件檢視的專案。
map_view_base：：Lookup 函式	查閱指定索引鍵所識別的專案，並擷取對應的值。
map_view_base：：Size 函式	擷取由 map_view_base 物件檢視的專案數目。
map_view_base：：Split 函式	將地圖檢視分割成兩個檢視。

迭代器

map_view_base是一個範圍，該範圍是由內部免費函式所定義， (每個函式都會擷取與標準語言功能相容的反覆運算器) 。因此，您可以使用範圍型 for 語句來列舉map_view_base物件所檢視的專案。

您也可以從map_view_base：：First函式擷取IIterator，並使用該函式逐一查看map_view_base物件檢視的專案。

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

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

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

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

map_view_base：：First 函式

擷取 IIterator ，代表 map_view_base 物件檢視的第一個專案。

語法

auto First();

傳回值

IIterator，代表由map_view_base物件檢視的第一個專案。

map_view_base：：HasKey 函式

判斷指定的索引鍵是否屬於 由 map_view_base 物件檢視的專案。

語法

bool HasKey(K const& key) const noexcept;

參數

key 要尋找的索引鍵。

傳回值

true 如果找到包含索引鍵的專案，則為，否則 false 為。

map_view_base：：Lookup 函式

查閱指定索引鍵所識別的專案，並擷取對應的值。

語法

V Lookup(K const& key) const;

參數

key 要查閱的索引鍵。

傳回值

如果找到，則對應至所查閱之索引鍵的值，否則會擲回 winrt：：hresult_out_of_bounds 例外狀況。

map_view_base：：Size 函式

擷取 由 map_view_base 物件檢視的專案數目。

語法

uint32_t Size() const noexcept;

傳回值

值，表示 由 map_view_base 物件檢視的專案數目。

map_view_base：：Split 函式

將地圖檢視分割成兩個檢視。

語法

void Split(Windows::Foundation::Collections::IMapView<K, V>& first, Windows::Foundation::Collections::IMapView<K, V>& second) const noexcept;

參數

first 原始地圖的一半。

second 原始地圖的後半部。