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

  • Articolo

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

Nota

È possibile definire i propri tratti di handle (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 un file di codice sorgente personalizzato e fornire il proprio tipo di handle e implementazione. Sono disponibili altri dettagli nell'articolo MSDN Magazine Windows con C++.

Sintassi

template <typename T>
struct handle_type

Parametri di modelli

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

Requisiti

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

Spazio dei nomi: winrt

Intestazione: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluso per impostazione predefinita)

Alias del tipo di membro

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

Costruttori

Costruttore Descrizione
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
funzione handle_type::attach Collega a un valore di handle e ne assume la proprietà.
funzione handle_type::close Chiude l'handle sottostante.
funzione handle_type::d etach Scollega dall'handle sottostante.
funzione handle_type::get Restituisce l'handle sottostante deve essere passato a una funzione.
funzione handle_type::p ut Restituisce l'indirizzo dell'handle sottostante; questa funzione consente di chiamare i metodi che restituiscono riferimenti come parametri out tramite un puntatore a un handle.

Operatori membri

Operatore Descrizione
handle_type::operator bool Verifica se l'oggetto handle_type attualmente rappresenta 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 di un 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

Collega a un valore di handle e ne assume la proprietà.

Sintassi

void attach(handle_type::type value) noexcept;

Parametri

value Valore handle da collegare.

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, deve essere passato 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 i 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

Verifica se l'oggetto handle_type attualmente rappresenta 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 di un altro.

Sintassi

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

Parametri

leftright Valore handle_type il cui handle si scambia a vicenda con quello dell'altro parametro.

Vedi anche