Condividi tramite

Modello di struct winrt::handle_type (C++/WinRT)

  • Articolo

Modello per gli struct winrt::handle winrt::file_handle, tra gli altri.

Nota

È possibile definire tratti di handle personalizzati (vedere, ad esempio, handle_traits o file_handle_traits in \cppwinrt\winrt\base.h) e usarli con winrt::handle_type come typename T. Copiare uno di questi esempi da base.h nel proprio file di codice sorgente e fornire il proprio tipo di handle e implementazione. Per altri dettagli, vedere l'articolo di MSDN Magazine Windows con C++.

Sintassi

template <typename T>
struct handle_type

Parametri del modello

typename T Tipo di tratti che specifica il tipo di handle rappresentato (handle, handle di file o altro tipo).

Fabbisogno

SDK minimo supportato: Windows SDK versione 10.0.17134.0 (Windows 10, versione 1803)

Namespace: winrt

intestazione : %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (incluso per impostazione predefinita)

Alias del tipo di membro

Nome alias Digitare
handle_type::type Sinonimo di typename T::type, dove T è il parametro di modello typename T.

Costruttori

Costruttore Descrizione
del costruttore handle_type::handle_type Inizializza una nuova istanza dello struct handle_type, facoltativamente con una copia o uno spostamento dei dati di input.

Funzioni membro

Funzione Descrizione
handle_type::attach function Associa un valore handle e ne assume la proprietà.
handle_type::close funzione Chiude l'handle sottostante.
handle_type::d etach Scollega dall'handle sottostante.
handle_type::get della funzione Restituisce l'handle sottostante se è necessario passarlo a una funzione.
funzione handle_type::p ut Restituisce l'indirizzo dell'handle sottostante; questa funzione consente di chiamare metodi che restituiscono riferimenti come parametri out tramite un puntatore a un handle.

Operatori membro

Operatore Descrizione
handle_type::operator bool Controlla se l'oggetto handle_type rappresenta attualmente un handle valido.
handle_type::operator= (operatore di assegnazione) Assegna un valore all'oggetto handle_type.

Funzioni gratuite

Funzione Descrizione
funzione swap Scambia il contenuto dei due parametri handle_type in modo che contengano l'handle dell'altro.

Costruttore handle_type::handle_type

Inizializza una nuova istanza dello struct handle_type, facoltativamente con una copia o uno spostamento dei dati di input.

Sintassi

handle_type() noexcept;
explicit handle_type(handle_type::type value) noexcept;
handle_type(handle_type&& other) noexcept;

Parametri

value Valore che inizializza l'oggetto handle_type.

other Un altro handle_type che inizializza l'oggetto handle_type.

funzione handle_type::attach

Associa un valore handle e ne assume la proprietà.

Sintassi

void attach(handle_type::type value) noexcept;

Parametri

value Valore handle a cui collegarsi.

funzione handle_type::close

Chiude l'handle sottostante.

Sintassi

void close() noexcept;

funzione handle_type::d etach

Scollega dall'handle sottostante.

Sintassi

handle_type::type detach() noexcept;

Valore restituito

Handle sottostante rappresentato in precedenza dall'oggetto handle_type.

funzione handle_type::get

Restituisce l'handle sottostante, se necessario passarlo a una funzione.

Sintassi

handle_type::type get() const noexcept;

Valore restituito

Handle sottostante rappresentato dall'oggetto handle_type.

funzione handle_type::p ut

Restituisce l'indirizzo dell'handle sottostante; questa funzione consente di chiamare metodi che restituiscono riferimenti come parametri out tramite un puntatore a un handle.

Sintassi

handle_type::type* put() noexcept;

Valore restituito

Indirizzo dell'handle sottostante rappresentato dall'oggetto handle_type.

handle_type::operator bool

Controlla se l'oggetto handle_type rappresenta attualmente un handle valido.

Sintassi

explicit operator bool() const noexcept;

Valore restituito

true se l'oggetto handle_type rappresenta attualmente un handle valido; in caso contrario, false.

handle_type::operator= (operatore di assegnazione)

Assegna un valore all'oggetto handle_type.

Sintassi

winrt::handle_type& operator=(winrt::handle_type&& other) noexcept;

Parametri

other Valore handle_type da assegnare all'oggetto handle_type.

Valore restituito

Riferimento all'oggetto handle_type.

funzione swap

Scambia il contenuto dei due parametri handle_type in modo che contengano l'handle dell'altro.

Sintassi

void swap(winrt::handle_type& left, winrt::handle_type& right) noexcept;

Parametri

left right Valore handle_type il cui handle viene scambiato a vicenda con quello dell'altro parametro.

Vedere anche