Classe Platform::Collections::Map
Rappresenta una mappa, che è una raccolta di coppie chiave-valore. Implementa Windows::Foundation::Collections::IObservableMap per facilitare il data binding XAML.
Sintassi
template <
typename K,
typename V,
typename C = std::less<K>>
ref class Map sealed;
Parametri
K
Tipo di chiave nella coppia chiave-valore.
V
Tipo di valore nella coppia chiave-valore.
C
Tipo che fornisce un oggetto funzione che può confrontare due valori di elementi come chiavi di ordinamento per determinare l'ordine relativo nella mappa. Per impostazione predefinita, std::less<K>.
__is_valid_winrt_type() Funzione generata dal compilatore che convalida il tipo di K e V e fornisce un messaggio di errore descrittivo se il tipo non può essere archiviato nella mappa.
Osservazioni:
I tipi consentiti sono:
integer
classe di interfaccia^
classe di riferimento pubblica^
value struct
classe enum pubblica
La mappa è fondamentalmente un wrapper per std::map. Si tratta di un'implementazione concreta di C++ dei tipi Windows::Foundation::Collections::IMap<Windows::Foundation::Collections::IKeyValuePair<K,V>> e IObservableMap passati tra le interfacce di Windows Runtime pubbliche. Se tenti di usare un tipo Platform::Collections::Map in un parametro o valore restituito pubblico, viene generato l'errore del compilatore C3986. È possibile correggere l'errore modificando il tipo del parametro o il valore restituito in Windows::Foundation::Collections::IMap<K,V>.
Per altre informazioni, vedere Raccolte.
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| Map::Map | Inizializza una nuova istanza della classe Map. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| Map::Clear | Rimuove tutte le coppie chiave-valore dall'oggetto Map corrente. |
| Map::First | Restituisce un iteratore che specifica il primo elemento nella mappa. |
| Map::GetView | Restituisce una visualizzazione di sola lettura dell'oggetto Map corrente, ovvero Platform::Collections::MapView Class. |
| Map::HasKey | Determina se l'oggetto Map corrente contiene la chiave specificata. |
| Map::Insert | Aggiunge la coppia chiave-valore all'oggetto Map corrente. |
| Map::Lookup | Recupera l'elemento in corrispondenza della chiave specificata nell'oggetto Map corrente. |
| Map::Remove | Elimina la coppia chiave-valore specificata dall'oggetto Map corrente. |
| Map::Size | Restituisce il numero di elementi nell'oggetto Map corrente. |
Eventi
| Nome | Descrizione |
|---|---|
| Evento Map::MapChanged | Si verifica quando l'oggetto Map subisce delle modifiche. |
Gerarchia di ereditarietà
Map
Requisiti
Intestazione: collection.h
Spazio dei nomi: Platform::Collections
Metodo Map::Clear
Rimuove tutte le coppie chiave-valore dall'oggetto Map corrente.
Sintassi
virtual void Clear();
Metodo Map::First
Restituisce un iteratore che specifica il primo elemento nella mappa o nullptr se la mappa è vuota.
Sintassi
virtual Windows::Foundation::Collections::IIterator<
Windows::Foundation::Collections::IKeyValuePair<K, V>^>^ First();
Valore restituito
Iteratore che specifica il primo elemento nella mappa.
Osservazioni:
Un modo pratico per contenere l'iteratore restituito da First() consiste nell'assegnare il valore restituito a una variabile dichiarata con la parola chiave di deduzione del auto tipo. Ad esempio: auto x = myMap->First();.
Metodo Map::GetView
Restituisce una visualizzazione di sola lettura della mappa corrente; ovvero una classe Platform::Collections::MapView, che implementa l'interfaccia Windows::Foundation::Collections::IMapView<K,V>.
Sintassi
Windows::Foundation::Collections::IMapView<K, V>^ GetView();
Valore restituito
Oggetto MapView.
Metodo Map::HasKey
Determina se l'oggetto Map corrente contiene la chiave specificata.
Sintassi
bool HasKey(K key);
Parametri
key
Chiave usata per individuare l'elemento Map. Il tipo di chiave è typename K.
Valore restituito
true se la chiave viene trovata; in caso contrario, false.
Metodo Map::Insert
Aggiunge la coppia chiave-valore all'oggetto Map corrente.
Sintassi
virtual bool Insert(K key, V value);
Parametri
key
Chiave della coppia chiave-valore. Il tipo di chiave è typename K.
value
Valore della coppia chiave-valore. Il tipo di valore è typename V.
Valore restituito
true se la chiave di un elemento esistente nella mappa corrente corrisponde alla chiave e la parte del valore di tale elemento è impostata su value. false se nessun elemento esistente nella mappa corrente corrisponde alla chiave e i parametri chiave e valore vengono creati in una coppia chiave-valore e quindi aggiunta alla mappa corrente.
Metodo Map::Lookup
Recupera il valore di tipo V associato alla chiave specificata di tipo K, se la chiave esiste.
Sintassi
V Lookup(K key);
Parametri
key
Chiave utilizzata per individuare un elemento in Map. Il tipo di chiave è typename K.
Valore restituito
Valore associato alla chiave. Il tipo del valore restituito è typename V.
Osservazioni:
Se la chiave non esiste, viene generata un'eccezione Platform::OutOfBoundsException .
Costruttore Map::Map
Inizializza una nuova istanza della classe Map.
Sintassi
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());
Parametri
Init
Typename dell'oggetto Map corrente.
comp
Tipo che fornisce un oggetto funzione che può confrontare due valori di elementi come chiavi di ordinamento per determinare l'ordine relativo nella mappa.
m
Riferimento o rvalue a un map Class oggetto utilizzato per inizializzare la mappa corrente.
first
Iteratore di input del primo elemento in un intervallo di elementi utilizzato per inizializzare l'oggetto Map corrente.
last
Iteratore di input del primo elemento dopo un intervallo di elementi utilizzato per inizializzare l'oggetto Map corrente.
Evento Map::MapChanged
Generato quando un elemento viene inserito o rimosso dalla mappa.
Sintassi
event Windows::Foundation::Collections::MapChangedEventHandler<K,V>^ MapChanged;
Valore proprietà/Valore restituito
MapChangedEventHandler <K,V> che contiene informazioni sull'oggetto che ha generato l'evento e il tipo di modifica che si è verificato. Vedere anche Enumerazione IMapChangedEventArgs<K> e CollectionChange.
Equivalente .NET Framework
App di Windows Runtime che usano il progetto C# o Visual Basic IMap<K,V> come IDictionary<K,V>.
Metodo Map::Remove
Elimina la coppia chiave-valore specificata dall'oggetto Map corrente.
Sintassi
virtual void Remove(K key);
Parametri
key
Chiave della coppia chiave-valore. Il tipo di chiave è typename K.
Metodo Map::Size
Restituisce il numero di elementi Windows::Foundation::Collections::IKeyValuePair<K,V> nella mappa.
Sintassi
virtual property unsigned int Size;
Valore restituito
Numero di elementi in Map.
Vedi anche
Raccolte (C++/CX)
Spazio dei nomi della piattaforma
Creazione di componenti Windows Runtime in C++