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();
}
擷取 IIterator ,代表 map_view_base 物件檢視的第一個專案。
auto First();
IIterator,代表由map_view_base物件檢視的第一個專案。
判斷指定的索引鍵是否屬於 由 map_view_base 物件檢視的專案。
bool HasKey(K const& key) const noexcept;
key
要尋找的索引鍵。
true
如果找到包含索引鍵的專案,則為 ,否則 false
為 。
查閱指定索引鍵所識別的專案,並擷取對應的值。
V Lookup(K const& key) const;
key
要查閱的索引鍵。
如果找到,則對應至所查閱之索引鍵的值,否則會擲回 winrt::hresult_out_of_bounds 例外狀況。
擷取 由 map_view_base 物件檢視的專案數目。
uint32_t Size() const noexcept;
值,表示 由 map_view_base 物件檢視的專案數目。
將地圖檢視分割成兩個檢視。
void Split(Windows::Foundation::Collections::IMapView<K, V>& first, Windows::Foundation::Collections::IMapView<K, V>& second) const noexcept;
first
原始地圖的一半。
second
原始地圖的後半部。