Platform::Collections::Map – třída
Představuje mapu, což je kolekce párů klíč-hodnota. Implementuje Windows::Foundation::Collections::IObservableMap, aby pomohl s datovou vazbou XAML.
Syntaxe
template <
typename K,
typename V,
typename C = std::less<K>>
ref class Map sealed;
Parametry
K
Typ klíče v páru klíč-hodnota.
V
Typ hodnoty v páru klíč-hodnota.
C
Typ, který poskytuje objekt funkce, který může porovnat dvě hodnoty prvků jako klíče řazení k určení jejich relativního pořadí v mapě. Ve výchozím nastavení std::less<K>.
__is_valid_winrt_type() Funkce vygenerovaná kompilátorem, která ověřuje typ K a V a poskytuje popisnou chybovou zprávu, pokud typ nelze uložit do mapy.
Poznámky
Povolené typy jsou:
integers
interface – třída^
public ref – třída^
value – struktura
public enum – třída
Mapa je v podstatě obálka pro std::map. Jedná se o konkrétní implementaci Windows::Foundation::Collections::IMap<Windows::Foundation::Collections::IKeyValuePair<K,V>> a IObservableMap typy, které se předávají přes veřejná rozhraní prostředí Windows Runtime. Pokud se pokusíte použít Platform::Collections::Map typ ve veřejné návratové hodnotě nebo parametru, je vyvolána chyba kompilátoru C3986. Chybu můžete opravit změnou typu parametru nebo návratové hodnoty na Windows::Foundation::Collections::IMap<K,V>.
Další informace naleznete v tématu Kolekce.
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| Mapa::Mapa | Inicializuje novou instanci třídy Map. |
Veřejné metody
| Název | Popis |
|---|---|
| Mapa::Vymazat | Odebere všechny páry klíč-hodnota z aktuálního objektu Map. |
| Mapa::First | Vrátí iterátor, který určuje první prvek v mapě. |
| Mapa::GetView | Vrátí zobrazení aktuální mapy jen pro čtení; to znamená Platform::Collections::MapView – třída. |
| Mapa::HasKey | Určuje, zda aktuální mapa obsahuje zadaný klíč. |
| Mapa::Insert | Přidá zadaný pár klíč-hodnota do aktuálního objektu Map. |
| Mapa::Vyhledávání | Načte prvek v zadaném klíči v aktuálním objektu Map. |
| Mapa::Odebrat | Odstraní zadaný pár klíč-hodnota z aktuálního objektu Map. |
| Mapa::Velikost | Vrátí počet prvků v aktuálním objektu Map. |
Události
| Název | Popis |
|---|---|
| Map::MapChanged – událost | Nastane, když se mapa změní. |
Hierarchie dědičnosti
Map
Požadavky
Hlavička: collection.h
Obor názvů: Platform::Collections
Map::Clear – metoda
Odebere všechny páry klíč-hodnota z aktuálního objektu Map.
Syntaxe
virtual void Clear();
Map::First – metoda
Vrátí iterátor, který určuje první prvek v mapě nebo nullptr pokud je mapa prázdná.
Syntaxe
virtual Windows::Foundation::Collections::IIterator<
Windows::Foundation::Collections::IKeyValuePair<K, V>^>^ First();
Návratová hodnota
Iterátor, který určuje první prvek v mapě.
Poznámky
Pohodlný způsob, jak uchovávat iterátor vrácený First() je přiřadit návratovou hodnotu proměnné, která je deklarována pomocí klíčového slova odpočtu auto typu. Například auto x = myMap->First();.
Map::GetView – metoda
Vrátí zobrazení aktuální mapy jen pro čtení; to znamená Platform::Collections::MapView Třída, která implementuje Windows::Foundation::Collections::IMapView<K,V> rozhraní.
Syntaxe
Windows::Foundation::Collections::IMapView<K, V>^ GetView();
Návratová hodnota
Objekt MapView .
Map::HasKey – metoda
Určuje, zda aktuální mapa obsahuje zadaný klíč.
Syntaxe
bool HasKey(K key);
Parametry
key
Klíč použitý k vyhledání elementu Map. Typ klíče je typename K.
Návratová hodnota
trueje-li nalezen klíč; v opačném případě . false
Map::Insert – metoda
Přidá zadaný pár klíč-hodnota do aktuálního objektu Map.
Syntaxe
virtual bool Insert(K key, V value);
Parametry
key
Klíčová část páru klíč-hodnota. Typ klíče je typename K.
value
Část hodnoty páru klíč-hodnota. Typ hodnoty je typename V.
Návratová hodnota
true pokud klíč existujícího prvku v aktuální mapě odpovídá klíč a hodnota část tohoto prvku je nastavena na hodnotu. false Pokud žádný existující prvek v aktuální mapě odpovídá klíči a parametry klíč a hodnota jsou provedeny do páru klíč-hodnota a pak přidán do aktuální mapy.
Map::Lookup – metoda
Načte hodnotu typu V, která je přidružená k zadanému klíči typu K, pokud klíč existuje.
Syntaxe
V Lookup(K key);
Parametry
key
Klíč použitý k vyhledání prvku v mapě. Typ klíče je typename K.
Návratová hodnota
Hodnota spárovaná s klíčem. Typ návratové hodnoty je typename V.
Poznámky
Pokud klíč neexistuje, vyvolá se výjimka Platform::OutOfBoundsException .
Map::Map – konstruktor
Inicializuje novou instanci třídy Map.
Syntaxe
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());
Parametry
Init
Název typu aktuální mapy.
Comp
Typ, který poskytuje objekt funkce, který může porovnat dvě hodnoty prvků jako klíče řazení k určení jejich relativního pořadí v mapě.
m
Odkaz nebo rvalue na map Class hodnotu, která se používá k inicializaci aktuální mapy.
první
Vstupní iterátor prvního prvku v oblasti prvků, které se používají k inicializaci aktuálního mapování.
poslední
Vstupní iterátor prvního prvku za rozsahem prvků použitých k inicializaci aktuálního mapování.
Map::MapChanged – událost
Vyvolá se při vložení nebo odebrání položky z mapy.
Syntaxe
event Windows::Foundation::Collections::MapChangedEventHandler<K,V>^ MapChanged;
Hodnota vlastnosti / návratová hodnota
MapChangedEventHandler <K,V>, který obsahuje informace o objektu, který vyvolal událost, a druh změny, ke které došlo. Viz také IMapChangedEventArgs<K> a CollectionChange – výčet.
Ekvivalent v rozhraní .NET Framework
prostředí Windows Runtime aplikace, které používají IMap< projektu jazyka C# nebo Visual BasicK,V> jako IDictionary<K,V>.
Map::Remove – metoda
Odstraní zadaný pár klíč-hodnota z aktuálního objektu Map.
Syntaxe
virtual void Remove(K key);
Parametry
key
Klíčová část páru klíč-hodnota. Typ klíče je typename K.
Map::Size – metoda
Vrátí počet prvků Windows::Foundation::Collections::IKeyValuePair<K,V> v mapě.
Syntaxe
virtual property unsigned int Size;
Návratová hodnota
Počet prvků v mapě.
Viz také
Kolekce (C++/CX)
Obor názvů platformy
Vytváření komponent prostředí Windows Runtime v jazyce C++