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.
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. |