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

基類,您可以從中衍生來實作自己的自訂檢視或範圍,以實作關聯集合中連續專案序列。 如需詳細資訊和程式碼範例,請參閱 使用 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 原始地圖的後半部。

另請參閱