Spazio dei nomi winrt (C++/WinRT)

Lo spazio dei nomi winrt fornisce tipi di dati personalizzati appartenenti a C++/WinRT, ovvero la proiezione del linguaggio C++17 standard e moderna per le API di Windows Runtime (WinRT). Questi tipi personalizzati forniscono conversioni appropriate da e verso tipi standard, in modo che, gran parte del tempo, sia possibile continuare a usare le funzionalità del linguaggio C++ standard usate e il codice sorgente già disponibile.

Inoltre, fornito nello spazio dei nomi winrt sono funzioni (per la creazione di istanze della classe di runtime, boxing e unboxing e così via), puntatori intelligenti e altre funzionalità.

Tipi nello spazio dei nomi winrt

Tipo	Descrizione
Modello di struct agile_ref	Tipo che rappresenta un riferimento agile a un oggetto o a un'interfaccia C++/WinRT.
Struct apartment_context	Acquisisce il contesto del thread all'interno di una coroutine in modo che possa essere ripristinato in un secondo momento.
Modello di struct array_view	Visualizzazione, o intervallo, di una serie contigua di valori.
Struct indicatore auto_revoke_t	Tipo di marcatore utilizzato per richiedere un revocatore di eventi durante la registrazione di un delegato per gestire un evento.
modello di struct marcatori mascherati	Tipo di marcatore usato per indicare che un'interfaccia implementata non deve essere segnalata da IInspectable::GetIids
Struct clock	Tipo contenente funzioni helper statiche per la conversione di un oggetto Windows::Foundation::D ateTime (ovvero std::chrono::time_point) in e dawinrt::file_time e da e verso time_t.
Modello di struct com_array	Visualizzazione, o intervallo, di una serie contigua di valori per il passaggio da e verso le API di Windows Runtime.
Modello di struct com_ptr	Modello di puntatore intelligente COM con conteggio dei riferimenti.
Struct marcatore componibile	Tipo di marcatore utilizzato per indicare che il tipo può essere la classe interna di una classe componibile.
Struct del marcatore di composizione	Tipo di marcatore utilizzato per indicare che il tipo è la classe esterna di una classe componibile.
deferrable_event_args	Tipo che è possibile usare per implementare (produrre) il modello di evento rinviabile.
Modello di struct delegate	Tipo che è possibile usare per dichiarare un tipo delegato personalizzato per gli eventi personalizzati.
Modello di struct event	Tipo che è possibile usare per dichiarare e implementare un evento di un tipo delegato specificato.
Modello di struct event_revoker	Quando si registra un delegato, è possibile richiedere un revocatore di eventi, che è possibile usare per revocare automaticamente o manualmente il delegato.
Struct event_token	Token restituito durante la registrazione di un delegato di gestione degli eventi con un evento; può essere usato per revocare la registrazione dello stesso delegato.
Struct file_handle	Rappresenta un oggetto handle di file di Windows.
Struct fire_and_forget	Usa questo tipo restituito per rendere la coroutine un fire-and-forget.
Struct guid	Rappresenta un identificatore univoco globale (GUID).
Struct handle	Rappresenta un oggetto handle di Windows.
Modello di struct handle_type	Modello per gli struct winrt::handle e winrt::file_handle .
Struct hstring	Raccolta sequenziale di caratteri Unicode UTF-16 che rappresentano una stringa di testo.
Struct hresult_access_denied	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_ACCESSDENIED.
Struct hresult_canceled	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT ERROR_CANCELLED.
Struct hresult_changed_state	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_CHANGED_STATE.
Struct hresult_class_not_available	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT CLASS_E_CLASSNOTAVAILABLE.
Struct hresult_error	Tipo che rappresenta un codice di errore HRESULT.
Struct hresult_illegal_delegate_assignment	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_ILLEGAL_DELEGATE_ASSIGNMENT.
Struct hresult_illegal_method_call	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_ILLEGAL_METHOD_CALL.
Struct hresult_illegal_state_change	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_ILLEGAL_STATE_CHANGE.
Struct hresult_invalid_argument	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_INVALIDARG.
Struct hresult_no_interface	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_NOINTERFACE.
Struct hresult_not_implemented	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_NOTIMPL.
Struct hresult_out_of_bounds	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT E_BOUNDS.
Struct hresult_wrong_thread	Tipo derivato da winrt::hresult_error, che rappresenta un codice di errore HRESULT RPC_E_WRONG_THREAD.
Modello di struct implements	Modello di struct di base che implementa una o più interfacce Windows Runtime per conto di un tipo derivato.
Modello di struct map_base	Classe di base, da cui derivare, che rappresenta una raccolta associativa non osservabile.
Modello di struct map_view_base	Una classe base, da cui derivare, che rappresenta una visualizzazione di una sequenza contigua di elementi in una raccolta associativa.
Struct marcatore no_module_lock	Tipo di marcatore utilizzato per indicare che le istanze di un tipo non vengono conteggiati per il conteggio degli oggetti modulo.
Struct indicatore no_weak_ref	Tipo di marcatore utilizzato per rifiutare esplicitamente il supporto dei riferimenti deboli.
Struct indicatore non_agile	Tipo di marcatore usato per indicare che il tipo non è agile e di conseguenza non implementa l'interfaccia IAgileObject.
Modello di struct observable_map_base	Classe di base, da cui derivare, che rappresenta una raccolta associativa osservabile.
Modello di struct observable_vector_base	Classe base, da cui derivare, che rappresenta un vettore osservabile.
Struct indicatore static_lifetime	Tipo di marcatore usato per acconsentire esplicitamente a una factory di attivazione nella durata statica.
Modello di struct vector_base	Una classe base, da cui derivare, che rappresenta una raccolta generica non osservabile nota come vettore.
Modello di struct vector_view_base	Classe di base da cui è possibile derivare per implementare una visualizzazione personalizzata, o un intervallo, di una sequenza contigua di elementi in una raccolta per utilizzo generico.
Modello di struct weak_ref	Tipo che rappresenta un riferimento debole a un oggetto o a un'interfaccia C++/WinRT.
Struct Windows::Foundation::IUnknown	Ogni classe di runtime C++/WinRT (una classe di runtime di Windows o di terze parti) deriva da winrt::Windows::Foundation::IUnknown.

Funzioni nello spazio dei nomi winrt

Funzione	Descrizione
Funzione attach_abi	Funzione helper che collega un oggetto C++/WinRT a un handle o a un puntatore non elaborato proprietario di un riferimento alla destinazione.
Modello di funzione box_value	Modello di funzione che esegue il wrapping (o caselle) di un valore scalare o matrice all'interno di un oggetto classe di riferimento in modo che possa essere passato a una funzione che prevede IInspectable.
Modello di funzione capture	Un modello di funzione che chiama una funzione o un metodo specificato, acquisisce il puntatore di interfaccia risultante e lo restituisce come winrt::com_ptr.
Modello di funzione check_bool	Funzione helper che controlla se un valore è false e, in tal caso, recupera il valore dell'ultimo codice di errore del thread chiamante e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.
Funzione check_hresult	Funzione helper che controlla se un codice HRESULT rappresenta un errore e, in tal caso, genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.
Modello di funzione check_nt	Funzione helper che controlla se un codice rappresenta un errore e, in tal caso, esegue il mapping del valore di stato NT del codice di errore a un valore HRESULT e genera un'eccezione utilizzando un oggetto C++/WinRT che rappresenta il codice di errore.
Modello di funzione check_pointer	Funzione helper che controlla se un puntatore è Null e, in tal caso, recupera il valore dell'ultimo codice di errore del thread chiamante e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.
Modello di funzione check_win32	Funzione helper che controlla se un codice rappresenta un errore e, in tal caso, esegue il mapping del codice di errore di sistema del valore a un valore HRESULT e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.
Funzione copy_from_abi	Funzione helper che copia in un oggetto C++/WinRT da un handle o da un puntatore non elaborato.
Funzione copy_to_abi	Funzione helper che copia in un handle o in un puntatore da un oggetto C++/WinRT.
Modello di funzione create_instance	Modello di funzione che crea un singolo oggetto non inizializzato della classe associata a un CLSID specificato e lo restituisce come winrt::com_ptr o genera un'eccezione in caso di esito negativo.
Funzione detach_abi	Funzione helper che scollega un oggetto C++/WinRT dall'handle a cui si fa riferimento o dalla relativa interfaccia a cui si fa riferimento.
Modello di funzione from_abi	Funzione helper che, data un oggetto di un tipo proiettato, recupera un puntatore all'implementazione.
funzione get_abi	Funzione helper che recupera un puntatore all'interfaccia IUnknown sottostante di un oggetto C++/WinRT.
Modello di funzione get_activation_factory	Funzione helper che recupera la factory di attivazione per un tipo di classe Windows Runtime specificato.
Funzione get_cancellation_token	In una coroutine usare l'oggetto restituito da winrt::get_cancellation_token per eseguire il polling o per rispondere all'annullamento.
Funzione get_class_name	Funzione helper che recupera una stringa contenente il nome completo del tipo di una classe Windows Runtime specificata.
Funzione get_interfaces	Funzione helper che recupera una matrice contenente gli identificatori delle interfacce implementate da un oggetto C++/WinRT.
Funzione get_progress_token	In una coroutine usare l'oggetto restituito da winrt::get_progress_token per segnalare lo stato di avanzamento a un gestore di stato.
Modello di funzione get_self	Funzione helper che, data un oggetto di un tipo proiettato, recupera un puntatore all'implementazione.
Funzione get_trust_level	Funzione helper che recupera il livello di attendibilità di un oggetto C++/WinRT.
Funzione get_unknown	Funzione helper che restituisce l'indirizzo dell'interfaccia IUnknown non elaborata sottostante di un oggetto di un tipo proiettato.
Modello di funzione guid_of	Modello di funzione helper che recupera il GUID di una classe di runtime, una coclasse o un'interfaccia.
modello di funzione is_guid_of	Un modello di funzione helper che determina se il GUID specificato è quello di una delle classi di runtime, delle coclassi o delle interfacce specificate.
Modello di funzione make	Metodo factory che restituisce un'istanza di un tipo o di un'interfaccia proiettata quando viene parametrizzata con il tipo di implementazione corrispondente.
Modello di funzione make_agile	Funzione helper che restituisce un oggetto agile_ref , che rappresenta un riferimento agile a un oggetto o a un'interfaccia C++/WinRT.
Modello di funzione make_self	Metodo factory che restituisce un com_ptr a un'istanza del tipo di implementazione per una classe di runtime.
Modello di funzione make_weak	Funzione helper che restituisce un oggetto weak_ref , che rappresenta un riferimento debole a un oggetto o a un'interfaccia C++/WinRT.
modello di funzione name_of	Funzione helper che recupera una visualizzazione stringa contenente il nome completo del tipo di una determinata classe Windows Runtime.
funzione put_abi	Funzione helper che recupera l'indirizzo del puntatore dell'interfaccia IUnknown sottostante di un oggetto C++/WinRT in modo che possa essere impostato su un altro valore.
Funzione resume_after	Funzione helper che restituisce il controllo al chiamante e quindi riprende l'esecuzione in un thread del pool di thread dopo un ritardo.
Funzione resume_background	Funzione helper che restituisce il controllo al chiamante e riprende l'esecuzione in un thread del pool di thread.
Funzione resume_foreground	Funzione helper, da usare all'interno di una coroutine, che consente co_await di passare l'esecuzione a un thread in primo piano specifico.
resume_on_signal	Funzione che è possibile usare per sospendere fino a quando non viene segnalato un evento del kernel.
Modello di funzione single_threaded_map	Modello di funzione che crea e restituisce un oggetto di un tipo che implementa una raccolta associativa non osservabile (mappa). L'oggetto viene restituito come IMap.
Modello di funzione single_threaded_observable_map	Modello di funzione che crea e restituisce un oggetto di un tipo che implementa una raccolta associativa osservabile (mappa). L'oggetto viene restituito come IObservableMap.
Modello di funzione single_threaded_observable_vector	Modello di funzione che crea e restituisce un oggetto di un tipo che implementa una raccolta osservabile. L'oggetto viene restituito come IObservableVector.
Modello di funzione single_threaded_vector	Modello di funzione che crea e restituisce un oggetto di un tipo che implementa una raccolta per utilizzo generico. L'oggetto viene restituito come IVector.
Funzione swap	Funzione helper che scambia il contenuto di due valori.
Funzione throw_hresult	Funzione helper che accetta un codice di errore HRESULT e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.
Funzione throw_last_error	Funzione helper che recupera il valore dell'ultimo codice di errore del thread chiamante e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.
Funzione to_hresult	Funzione helper, da usare in un blocco catch, che trasforma l'ultima eccezione generata in un codice di errore HRESULT.
Funzione to_hstring	Funzione helper che converte un valore di input in winrt::hstring contenente la rappresentazione di stringa del valore.
Funzione to_string	Funzione helper che converte una stringa wide di input in una stringa std::string contenente una stringa stretta UTF-8.
Modello di funzione try_capture	Un modello di funzione che chiama una funzione o un metodo specificato, acquisisce l'output del puntatore dell'interfaccia dalla funzione o dal metodo e lo restituisce come winrt::com_ptr o un com_ptr vuoto se non è riuscito.
Modello di funzione try_create_instance	Modello di funzione che crea un singolo oggetto non inizializzato della classe associata a un CLSID specificato e lo restituisce come winrt::com_ptr o un com_ptr vuoto, se non riuscito.
modello di funzione try_get_activation_factory	Funzione helper che recupera la factory di attivazione per un tipo di classe Windows Runtime specificato o un com_ptr vuoto se non è riuscito.
Modello di funzione unbox_value	Modello di funzione che annulla la registrazione (o unbox) di un valore scalare o matrice dall'interno di un oggetto classe di riferimento in modo che possa essere elaborato in una funzione che prevede IInspectable.
Modello di funzione unbox_value_or	Modello di funzione che annulla la registrazione (o unbox) di un valore scalare dall'interno di un oggetto classe di riferimento, con un valore di fallback, in modo che possa essere elaborato in una funzione che prevede IInspectable.
Modello di funzione xaml_typename	Funzione helper che restituisce il nome del tipo di un tipo Windows Runtime, sotto forma di un oggetto Windows::UI::Xaml::Interop::TypeName.

Funzioni C++/WinRT che estendono le API Windows Runtime

Le funzioni di estensione esistono nei tipi di proiezione C++/WinRT per determinate API Windows Runtime. Ad esempio, winrt::Windows::Foundation::IAsyncAction è il tipo di proiezione C++/WinRT per IAsyncAction. Le funzioni di estensione non fanno parte della superficie dell'interfaccia binaria dell'applicazione (ABI) dei tipi di Windows Runtime effettivi, pertanto non sono elencati come membri delle API Windows Runtime. È tuttavia possibile chiamarli da qualsiasi progetto C++/WinRT.

WinRT API	Funzione	Descrizione
IAsyncAction	get, wait_for	Vedere Funzioni di estensione IAsyncAction C++/WinRT
IAsyncActionWithProgress	get, wait_for	Vedere Funzioni di estensione IAsyncActionWithProgress C++/WinRT
IAsyncOperation	get, wait_for	Vedere Funzioni di estensione IAsyncOperation C++/WinRT
IAsyncOperationWithProgress	get, wait_for	Vedere Funzioni di estensione IAsyncOperationWithProgress C++/WinRT
IBindableIterable	inizio, fine	Vedere Funzioni di estensione C++/WinRT IBindableIterable
IBindableIterator	begin, end, operator++, operator++(int), operator*	Vedere Funzioni di estensione IBindableIterator C++/WinRT
Ibuffer	data	Vedere Funzioni di estensione IBuffer C++/WinRT
IIterable	inizio, fine	Vedere Funzioni di estensione C++/WinRT IIterable
IIterator	operator++, operator++(int), operator*	Vedere Funzioni di estensione IIterator C++/WinRT
IKeyValuePair	operator==	Vedere Funzioni di estensione IKeyValuePair C++/WinRT
IMap	begin, end, TryLookup, TryRemove	Vedere Funzioni di estensione IMap C++/WinRT
IMapView	begin, end, TryLookup	Vedere Funzioni di estensione IMapView C++/WinRT
IMemoryBufferReference	data	Vedere Funzioni di estensione IMemoryBufferReference C++/WinRT
IVector	inizio, fine	Vedere Funzioni di estensione IVector C++/WinRT
IVectorView	inizio, fine	Vedere Funzioni di estensione IVectorView C++/WinRT

Altre funzioni

Funzione	Descrizione
Funzione GetRuntimeClassName	Funzione membro (di un tipo di implementazione generato) che restituisce una stringa contenente il nome completo del tipo della classe Windows Runtime implementata.

Vedi anche

C++/WinRT