Spazio dei nomi winrt (C++/WinRT)winrt namespace (C++/WinRT)

  • 10 minuti per la lettura

Lo spazio dei nomi WinRT fornisce tipi di dati personalizzati che appartengono a c++/WinRT — la proiezione del linguaggio c++ 17 standard e moderna per le API Windows Runtime (WinRT).The winrt namespace provides custom data types belonging to C++/WinRT—the standard, modern C++17 language projection for Windows Runtime (WinRT) APIs. Questi tipi personalizzati forniscono le conversioni appropriate da e verso i tipi standard in modo che, nella maggior parte dei casi, sia possibile continuare a usare le funzionalità del linguaggio C++ standard che si è abituati a usare e il codice sorgente già disponibile.These custom types provide appropriate conversions to and from standard types so that, much of the time, you can continue to use the standard C++ language features that you're accustomed to using, and the source code that you already have.

Sono inoltre disponibili nello spazio dei nomi WinRT le funzioni (per la creazione di istanze della classe di runtime, la conversione boxing e unboxing e così via), i puntatori intelligenti e altre funzionalità.Also provided in the winrt namespace are functions (for creating runtime class instances, boxing and unboxing, etc.), smart pointers, and other facilities.

Tipi nello spazio dei nomi WinRTTypes in the winrt namespace

TipoType DescrizioneDescription
Modello di struct agile_refagile_ref struct template Tipo che rappresenta un riferimento agile a un oggetto o a un'interfaccia C++/WinRT.A type representing an agile reference to a C++/WinRT object or interface.
Struct apartment_contextapartment_context struct Acquisisce il contesto del thread all'interno di una coroutine in modo che possa essere ripristinato in un secondo momento.Captures the thread context within a coroutine so that it can be restored later.
Modello di struct array_viewarray_view struct template Visualizzazione o span di una serie contigua di valori.A view, or span, of a contiguous series of values.
Struct indicatore auto_revoke_tauto_revoke_t marker struct Tipo di marcatore utilizzato per richiedere un Revocatore di evento quando si registra un delegato per gestire un evento.A marker type used to request an event revoker when registering a delegate to handle an event.
Struct clockclock struct Tipo contenente funzioni helper statiche per la conversione di Windows:: Foundation::D atetime (ovvero std:: chrono:: time_point) verso e da WinRT:: file_time e da e verso time_t.A type containing static helper functions for converting a Windows::Foundation::DateTime (that is, a std::chrono::time_point) to and from winrt::file_time, and to and from time_t.
Modello di struct com_arraycom_array struct template Visualizzazione, o span, di una serie di valori contigui per il passaggio da e verso API Windows Runtime.A view, or span, of a contiguous series of values for passing to and from Windows Runtime APIs.
Modello di struct com_ptrcom_ptr struct template Modello di puntatore intelligente COM con conteggio di riferimento.A reference-counted COM smart pointer template.
Modello di struct delegatedelegate struct template Tipo che è possibile usare per dichiarare un tipo delegato personalizzato per gli eventi personalizzati.A type that you can use to declare a custom delegate type for your own events.
Modello di struct eventevent struct template Tipo che è possibile usare per dichiarare e implementare un evento di un tipo delegato specificato.A type that you can use to declare and implement an event of a specified delegate type.
Modello di struct event_revokerevent_revoker struct template Quando si registra un delegato, è possibile richiedere un Revocatore di eventi, che può essere usato per revocare automaticamente o manualmente il delegato.When you register a delegate, you can request an event revoker, which you can use to automatically or manually revoke your delegate.
Struct event_tokenevent_token struct 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.A token returned when registering an event-handling delegate with an event; can be used to revoke the registration of the same delegate.
Struct file_handlefile_handle struct Rappresenta un oggetto handle di file di Windows.Represents a Windows file handle object.
Struct fire_and_forgetfire_and_forget struct Usare questo tipo restituito per fare in modo che una coroutine venga attivata e dimenticata.Use this return type to make your coroutine a fire-and-forget one.
Struct handlehandle struct Rappresenta un oggetto handle di Windows.Represents a Windows handle object.
Modello di struct handle_typehandle_type struct template Modello per gli struct WinRT:: handle e winrt:: file_handle .The template for the winrt::handle and winrt::file_handle structs.
Struct hstringhstring struct Raccolta sequenziale di caratteri Unicode UTF-16 che rappresenta una stringa di testo.A sequential collection of UTF-16 Unicode characters representing a text string.
Struct hresult_access_deniedhresult_access_denied struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_ACCESSDENIED HRESULT.A type derived from winrt::hresult_error, representing an E_ACCESSDENIED HRESULT error code.
Struct hresult_canceledhresult_canceled struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore ERROR_CANCELLED HRESULT.A type derived from winrt::hresult_error, representing an ERROR_CANCELLED HRESULT error code.
Struct hresult_changed_statehresult_changed_state struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_CHANGED_STATE HRESULT.A type derived from winrt::hresult_error, representing an E_CHANGED_STATE HRESULT error code.
Struct hresult_class_not_availablehresult_class_not_available struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore CLASS_E_CLASSNOTAVAILABLE HRESULT.A type derived from winrt::hresult_error, representing an CLASS_E_CLASSNOTAVAILABLE HRESULT error code.
Struct hresult_errorhresult_error struct Tipo che rappresenta un codice di errore HRESULT.A type representing an HRESULT error code.
Struct hresult_illegal_delegate_assignmenthresult_illegal_delegate_assignment struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_ILLEGAL_DELEGATE_ASSIGNMENT HRESULT.A type derived from winrt::hresult_error, representing an E_ILLEGAL_DELEGATE_ASSIGNMENT HRESULT error code.
Struct hresult_illegal_method_callhresult_illegal_method_call struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_ILLEGAL_METHOD_CALL HRESULT.A type derived from winrt::hresult_error, representing an E_ILLEGAL_METHOD_CALL HRESULT error code.
Struct hresult_illegal_state_changehresult_illegal_state_change struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_ILLEGAL_STATE_CHANGE HRESULT.A type derived from winrt::hresult_error, representing an E_ILLEGAL_STATE_CHANGE HRESULT error code.
Struct hresult_invalid_argumenthresult_invalid_argument struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_INVALIDARG HRESULT.A type derived from winrt::hresult_error, representing an E_INVALIDARG HRESULT error code.
Struct hresult_no_interfacehresult_no_interface struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_NOINTERFACE HRESULT.A type derived from winrt::hresult_error, representing an E_NOINTERFACE HRESULT error code.
Struct hresult_not_implementedhresult_not_implemented struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_NOTIMPL HRESULT.A type derived from winrt::hresult_error, representing an E_NOTIMPL HRESULT error code.
Struct hresult_out_of_boundshresult_out_of_bounds struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore E_BOUNDS HRESULT.A type derived from winrt::hresult_error, representing an E_BOUNDS HRESULT error code.
Struct hresult_wrong_threadhresult_wrong_thread struct Tipo derivato da WinRT:: hresult_error, che rappresenta un codice di errore RPC_E_WRONG_THREAD HRESULT.A type derived from winrt::hresult_error, representing an RPC_E_WRONG_THREAD HRESULT error code.
Modello di struct implementsimplements struct template Modello struct di base che implementa una o più interfacce Windows Runtime per conto di un tipo derivato.A base struct template that implements one or more Windows Runtime interfaces on behalf of a derived type.
Modello di struct map_basemap_base struct template Classe base, da cui derivare, che rappresenta una raccolta associativa non osservabile.A base class, for you to derive from, that represents a non-observable associative collection.
Modello di struct map_view_basemap_view_base struct template Classe base, da cui derivare, che rappresenta una visualizzazione di una sequenza contigua di elementi in una raccolta associativa.A base class, for you to derive from, that represents a view of a contiguous sequence of elements in an associative collection.
Struct indicatore no_weak_refno_weak_ref marker struct Tipo di marcatore utilizzato per rifiutare esplicitamente il supporto di riferimento debole.A marker type used to opt out of weak reference support.
Struct indicatore non_agilenon_agile marker struct Tipo di marcatore utilizzato per indicare che il tipo non è agile e, di conseguenza, non implementa l' interfaccia IAgileObject.A marker type used to indicate that your type is not agile, and consequently does not implement the IAgileObject interface.
Modello di struct observable_map_baseobservable_map_base struct template Classe base, da cui derivare, che rappresenta una raccolta associativa osservabile.A base class, for you to derive from, that represents an observable associative collection.
Modello di struct observable_vector_baseobservable_vector_base struct template Classe base, da cui derivare, che rappresenta un vettore osservabile.A base class, for you to derive from, that represents an observable vector.
Struct indicatore static_lifetimestatic_lifetime marker struct Tipo di marcatore usato per scegliere una factory di attivazione in una durata statica.A marker type used to opt an activation factory in to static lifetime.
Modello di struct vector_basevector_base struct template Classe base, da cui derivare, che rappresenta una raccolta di utilizzo generico non osservabile nota come vettore.A base class, for you to derive from, that represents a non-observable general-purpose collection known as a vector.
Modello di struct vector_view_basevector_view_base struct template Una classe di base da cui è possibile derivare per implementare una visualizzazione personalizzata, o span, di una sequenza contigua di elementi in una raccolta di utilizzo generico.A base class from which you can derive to implement your own custom view, or span, of a contiguous sequence of elements in a general-purpose collection.
Modello di struct weak_refweak_ref struct template Tipo che rappresenta un riferimento debole a un oggetto o a un'interfaccia C++/WinRT.A type representing a weak reference to a C++/WinRT object or interface.
Struct Windows::Foundation::IUnknownWindows::Foundation::IUnknown struct Ogni classe di runtime C++/WinRT (se una classe di runtime di Windows o di terze parti) deriva da WinRT:: Windows:: Foundation:: IUnknown.Every C++/WinRT runtime class (whether a Windows or a third party runtime class) derives from winrt::Windows::Foundation::IUnknown.

Funzioni nello spazio dei nomi WinRTFunctions in the winrt namespace

FunzioneFunction DescrizioneDescription
Funzione attach_abiattach_abi function Funzione di supporto che connette un oggetto C++/WinRT a un handle o a un puntatore non elaborato che possiede un riferimento alla relativa destinazione.A helper function that attaches a C++/WinRT object to a handle, or to a raw pointer that owns a reference to its target.
Modello di funzione box_valuebox_value function template Modello di funzione che esegue il wrapping di un valore scalare all'interno di un oggetto della classe di riferimento in modo che possa essere passato a una funzione che prevede IInspectable.A function template that wraps (or boxes) a scalar value inside a reference class object so that it can be passed to a function that expects IInspectable.
Modello di funzione capturecapture function template 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.A function template that calls a specified function or method, captures the resulting interface pointer, and returns it as a winrt::com_ptr.
Modello di funzione check_boolcheck_bool function template Funzione helper che controlla se un valore è false e, in caso affermativo, recupera il valore del codice dell'ultimo errore del thread chiamante e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.A helper function that checks whether a value is false and, if so, retrieves the calling thread's last-error code value, and throws an exception using a C++/WinRT object that represents that error code.
Funzione check_hresultcheck_hresult function Funzione helper che controlla se un codice HRESULT rappresenta un errore e, in caso affermativo, genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.A helper function that checks whether an HRESULT code represents an error and, if so, throws an exception using a C++/WinRT object that represents the error code.
Modello di funzione check_ntcheck_nt function template Funzione helper che controlla se un codice rappresenta un errore e, in caso affermativo, esegue il mapping del valore di stato NT del codice di errore a un valore HRESULT e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.A helper function that checks whether a code represents an error and, if so, maps the NT status value of the error code to an HRESULT value and throws an exception using a C++/WinRT object that represents the error code.
Modello di funzione check_pointercheck_pointer function template Funzione helper che controlla se un puntatore è null e, in caso affermativo, recupera il valore del codice dell'ultimo errore del thread chiamante e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.A helper function that checks whether a pointer is null and, if so, retrieves the calling thread's last-error code value, and throws an exception using a C++/WinRT object that represents that error code.
Modello di funzione check_win32check_win32 function template Funzione helper che controlla se un codice rappresenta un errore e, in caso affermativo, esegue il mapping del codice di errore del sistema del valore a un valore HRESULT e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.A helper function that checks whether a code represents an error and, if so, maps the system error code of the value to an HRESULT value and throws an exception using a C++/WinRT object that represents the error code.
Funzione copy_from_abicopy_from_abi function Funzione helper che copia in un oggetto C++/WinRT da un handle o da un puntatore non elaborato.A helper function that copies to a C++/WinRT object from a handle, or from a raw pointer.
Funzione copy_to_abicopy_to_abi function Funzione helper che copia in un handle o in un puntatore da un oggetto C++/WinRT.A helper function that copies to a handle, or to a pointer from a C++/WinRT object.
Modello di funzione create_instancecreate_instance function template 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.A function template that creates a single uninitialized object of the class associated with a specified CLSID, and returns it as a winrt::com_ptr or throws if not successful.
Funzione detach_abidetach_abi function Funzione di supporto che scollega un oggetto C++/WinRT dal relativo handle a cui viene fatto riferimento o dall'interfaccia a cui si fa riferimento.A helper function that detaches a C++/WinRT object from its referenced handle, or from its referenced interface.
Modello di funzione from_abifrom_abi function template Funzione di supporto che, dato un oggetto di un tipo proiettato, recupera un puntatore all'implementazione.A helper function which, given an object of a projected type, retrieves a pointer to the implementation.
funzione get_abiget_abi function Funzione di supporto che recupera un puntatore all' interfaccia IUnknownsottostante dell'oggetto C++/WinRT.A helper function that retrieves a pointer to a C++/WinRT object's underlying IUnknown interface.
Modello di funzione get_activation_factoryget_activation_factory function template Funzione di supporto che recupera la factory di attivazione per un tipo di classe di Windows Runtime specificato.A helper function that retrieves the activation factory for a specified Windows Runtime class type.
Funzione get_cancellation_tokenget_cancellation_token function In una coroutine usare l'oggetto restituito da WinRT:: get_cancellation_token per eseguire il polling o per rispondere all'annullamento.In a coroutine, use the object returned by winrt::get_cancellation_token to poll for, or to respond to, cancellation.
Funzione get_class_nameget_class_name function Funzione di supporto che recupera una stringa contenente il nome completo del tipo di una classe Windows Runtime specificata.A helper function that retrieves a string containing the fully-qualified type name of a specified Windows Runtime class.
Funzione get_interfacesget_interfaces function Funzione di supporto che recupera una matrice contenente gli identificatori delle interfacce implementate da un oggetto C++/WinRT.A helper function that retrieves an array containing the identifiers of the interfaces that are implemented by a C++/WinRT object.
Funzione get_progress_tokenget_progress_token function In una coroutine usare l'oggetto restituito da WinRT:: get_progress_token per segnalare lo stato di avanzamento a un gestore di stato.In a coroutine, use the object returned by winrt::get_progress_token to report progress back to a progress handler.
Modello di funzione get_selfget_self function template Funzione di supporto che, dato un oggetto di un tipo proiettato, recupera un puntatore all'implementazione.A helper function which, given an object of a projected type, retrieves a pointer to the implementation.
Funzione get_trust_levelget_trust_level function Funzione di supporto che recupera il livello di attendibilità di un oggetto C++/WinRT.A helper function that retrieves the trust level of a C++/WinRT object.
Funzione get_unknownget_unknown function Funzione di supporto che restituisce l'indirizzo dell' interfaccia IUnknown non elaborata sottostante di un oggetto di un tipo proiettato.A helper function that returns the address of the underlying raw IUnknown interface of an object of a projected type.
Modello di funzione guid_ofguid_of function template Modello di funzione helper che recupera il GUID di una classe di runtime, una coclasse o un'interfaccia.A helper function template that retrieves the GUID of a runtime class, coclass, or interface.
Modello di funzione makemake function template Metodo Factory che restituisce un'istanza di un tipo o di un'interfaccia proiettata quando viene parametrizzato con il tipo di implementazione corrispondente.A factory method that returns an instance of a projected type or interface when parameterized with the corresponding implementation type.
Modello di funzione make_agilemake_agile function template Funzione di supporto che restituisce un oggetto agile_ref , che rappresenta un riferimento agile a un oggetto o a un'interfaccia C++/WinRT.A helper function that returns an agile_ref object, representing an agile reference to a C++/WinRT object or interface.
Modello di funzione make_selfmake_self function template Metodo Factory che restituisce un com_ptr a un'istanza del tipo di implementazione per una classe di Runtime.A factory method that returns a com_ptr to an instance of the implementation type for a runtime class.
Modello di funzione make_weakmake_weak function template Funzione di supporto che restituisce un oggetto weak_ref , che rappresenta un riferimento debole a un oggetto o a un'interfaccia C++/WinRT.A helper function that returns a weak_ref object, representing a weak reference to a C++/WinRT object or interface.
funzione put_abiput_abi function Funzione di supporto che recupera l'indirizzo di un puntatore a interfaccia IUnknown sottostante dell'oggetto C++/WinRT in modo che possa essere impostato su un altro valore.A helper function that retrieves the address of a C++/WinRT object's underlying IUnknown interface pointer so that it can be set to another value.
funzione resume_afterresume_after function Funzione di supporto che restituisce il controllo al chiamante, quindi riprende l'esecuzione in un thread del pool di thread dopo un ritardo.A helper function that returns control to the caller, and then resumes execution on a thread pool thread after a delay.
Funzione resume_backgroundresume_background function Funzione di supporto che restituisce il controllo al chiamante e riprende l'esecuzione in un thread del pool di thread.A helper function that returns control to the caller, and resumes execution on a thread pool thread.
Funzione resume_foregroundresume_foreground function Funzione di supporto — da usare all'interno di una coroutine — che è possibile co_await passare a un thread in primo piano specifico.A helper function—for use within a coroutine—that you can co_await to switch execution to a specific foreground thread.
resume_on_signalresume_on_signal Funzione che è possibile usare per sospendere la segnalazione di un evento kernel.A function that you can use to suspend until a kernel event is signaled.
Modello di funzione single_threaded_mapsingle_threaded_map function template Modello di funzione che crea e restituisce un oggetto di un tipo che implementa una raccolta associativa non osservabile (Map).A function template that creates and returns an object of a type that implements a non-observable associative collection (map). L'oggetto viene restituito come IMAP.The object is returned as an IMap.
Modello di funzione single_threaded_observable_mapsingle_threaded_observable_map function template Modello di funzione che crea e restituisce un oggetto di un tipo che implementa un insieme associativo osservabile (Map).A function template that creates and returns an object of a type that implements an observable associative collection (map). L'oggetto viene restituito come IObservableMap.The object is returned as an IObservableMap.
Modello di funzione single_threaded_observable_vectorsingle_threaded_observable_vector function template Modello di funzione che crea e restituisce un oggetto di un tipo che implementa una raccolta osservabile.A function template that creates and returns an object of a type that implements an observable collection. L'oggetto viene restituito come IObservableVector.The object is returned as an IObservableVector.
Modello di funzione single_threaded_vectorsingle_threaded_vector function template Modello di funzione che crea e restituisce un oggetto di un tipo che implementa una raccolta di utilizzo generico.A function template that creates and returns an object of a type that implements a general-purpose collection. L'oggetto viene restituito come IVector.The object is returned as an IVector.
Funzione swapswap function Funzione di supporto che scambia il contenuto di due valori.A helper function that swaps the contents of two values.
Funzione throw_hresultthrow_hresult function Funzione di supporto che accetta un codice di errore HRESULT e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.A helper function that takes a HRESULT error code, and throws an exception using a C++/WinRT object that represents that error code.
Funzione throw_last_errorthrow_last_error function Funzione di supporto che recupera il valore del codice dell'ultimo errore del thread chiamante e genera un'eccezione usando un oggetto C++/WinRT che rappresenta il codice di errore.A helper function that retrieves the calling thread's last-error code value, and throws an exception using a C++/WinRT object that represents that error code.
Funzione to_hresultto_hresult function Funzione di supporto, da utilizzare in un blocco catch, che converte l'ultima eccezione generata in un codice di errore HRESULT.A helper function, for use in a catch block, that turns the last exception thrown into a HRESULT error code.
Funzione to_hstringto_hstring function Funzione di supporto che converte un valore di input in WinRT:: HString che contiene la rappresentazione di stringa del valore.A helper function that converts an input value to a winrt::hstring containing the value's string representation.
Funzione to_stringto_string function Funzione di supporto che converte una stringa a caratteri wide di input in un std:: String contenente una stringa di tipo Narrow UTF-8.A helper function that converts an input wide string to a std::string containing a UTF-8 narrow string.
Modello di funzione try_capturetry_capture function template Un modello di funzione che chiama una funzione o un metodo specificato, acquisisce il puntatore di interfaccia restituito dalla funzione o dal metodo e lo restituisce come WinRT:: com_ptr o una com_ptr vuota in caso di esito negativo.A function template that calls a specified function or method, captures the interface pointer that's output from the function or method, and returns it as a winrt::com_ptr or an empty com_ptr if not successful.
Modello di funzione try_create_instancetry_create_instance function template 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 una com_ptr vuota in caso di esito negativo.A function template that creates a single uninitialized object of the class associated with a specified CLSID, and returns it as a winrt::com_ptr or an empty com_ptr if not successful.
Modello di funzione unbox_valueunbox_value function template Modello di funzione che consente di annullare il wrapping di un valore scalare dall'interno di un oggetto della classe di riferimento in modo che possa essere elaborato in una funzione che prevede IInspectable.A function template that unwraps (or unboxes) a scalar value from inside a reference class object so that it can be processed in a function that expects IInspectable.
Modello di funzione unbox_value_orunbox_value_or function template Modello di funzione che consente di annullare il wrapping di un valore scalare dall'interno di un oggetto della classe di riferimento, con un valore di fallback, in modo che possa essere elaborato in una funzione che prevede IInspectable.A function template that unwraps (or unboxes) a scalar value from inside a reference class object, with a fallback value, so that it can be processed in a function that expects IInspectable.
Modello di funzione xaml_typenamexaml_typename function template Funzione di supporto che restituisce il nome del tipo di un tipo di Windows Runtime, nel formato di un oggetto Windows:: UI:: XAML:: Interop:: typeName .A helper function that returns the type name of a Windows Runtime type, in the form of a Windows::UI::Xaml::Interop::TypeName object.

Altre funzioniOther functions

FunzioneFunction DescrizioneDescription
Funzione GetRuntimeClassNameGetRuntimeClassName function Funzione membro (di un tipo di implementazione generato) che restituisce una stringa contenente il nome completo del tipo della classe Windows Runtime da implementare.A member function (of a generated implementation type) that returns a string containing the fully-qualified type name of the Windows Runtime class being implemented.

Vedere ancheSee also

C++/WinRTC++/WinRT