Modelo de struct winrt::handle_type (C++/WinRT)
O modelo para structs winrt::handle e winrt::file_handle , entre outros.
Observação
Você pode definir seus próprios traços de identificador (veja, por exemplo, handle_traits ou file_handle_traits ), \cppwinrt\winrt\base.h
e usá-los com winrt::handle_type como typename T
. Copie um desses exemplos de seu próprio arquivo de base.h
código-fonte e forneça seu próprio tipo de identificador e implementação. Há mais detalhes no artigo da Revista MSDN Windows com C++.
Syntax
template <typename T>
struct handle_type
Parâmetros de modelo
typename T
Um tipo de característica que especifica o tipo de identificador que está sendo representado (um identificador, um identificador de arquivo ou algum outro tipo).
Requisitos
SDK com suporte mínimo: Windows SDK versão 10.0.17134.0 (Windows 10, versão 1803)
Namespace: winrt
Cabeçalho: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluído por padrão)
Aliases de tipo de membro
Nome do alias | Tipo |
---|---|
handle_type::type | Um sinônimo para o nome de tipo T::type, em que T é o parâmetro de typename T modelo. |
Construtores
Construtor | Descrição |
---|---|
construtor handle_type::handle_type | Inicializa uma nova instância do struct handle_type , opcionalmente com uma cópia ou movimentação dos dados de entrada. |
Funções de membro
Função | Descrição |
---|---|
função handle_type::attach | Anexa a um valor de identificador e assume a propriedade dele. |
função handle_type::close | Fecha o identificador subjacente. |
Função handle_type::d etach | Desanexa do identificador subjacente. |
função handle_type::get | Retorna o identificador subjacente caso precise passá-lo para uma função. |
Função handle_type::p ut | Retorna o endereço do identificador subjacente; essa função ajuda você a chamar métodos que retornam referências como parâmetros out por meio de um ponteiro para um identificador. |
Operadores membros
Operador | Descrição |
---|---|
handle_type::operador bool | Verifica se o objeto handle_type representa ou não um identificador válido no momento. |
handle_type::operator= (operador de atribuição) | Atribui um valor ao objeto handle_type . |
Funções gratuitas
Função | Descrição |
---|---|
função swap | Troca o conteúdo dos dois parâmetros handle_type para que eles contenham o identificador um do outro. |
construtor handle_type::handle_type
Inicializa uma nova instância do struct handle_type , opcionalmente com uma cópia ou movimentação dos dados de entrada.
Sintaxe
handle_type() noexcept;
explicit handle_type(handle_type::type value) noexcept;
handle_type(handle_type&& other) noexcept;
Parâmetros
value
Um valor que inicializa o objeto handle_type .
other
Outro handle_type que inicializa o objeto handle_type .
função handle_type::attach
Anexa a um valor de identificador e assume a propriedade dele.
Sintaxe
void attach(handle_type::type value) noexcept;
Parâmetros
value
Um valor de identificador a ser anexado.
função handle_type::close
Fecha o identificador subjacente.
Syntax
void close() noexcept;
Função handle_type::d etach
Desanexa do identificador subjacente.
Sintaxe
handle_type::type detach() noexcept;
Valor retornado
O identificador subjacente anteriormente representado pelo objeto handle_type .
função handle_type::get
Retorna o identificador subjacente, caso precise passá-lo para uma função.
Sintaxe
handle_type::type get() const noexcept;
Valor retornado
O identificador subjacente representado pelo objeto handle_type .
Função handle_type::p ut
Retorna o endereço do identificador subjacente; essa função ajuda você a chamar métodos que retornam referências como parâmetros out por meio de um ponteiro para um identificador.
Sintaxe
handle_type::type* put() noexcept;
Valor retornado
O endereço do identificador subjacente representado pelo objeto handle_type .
handle_type::operador bool
Verifica se o objeto handle_type representa ou não um identificador válido no momento.
Sintaxe
explicit operator bool() const noexcept;
Valor retornado
true
se o objeto handle_type atualmente representa um identificador válido, caso contrário false
.
handle_type::operator= (operador de atribuição)
Atribui um valor ao objeto handle_type .
Sintaxe
winrt::handle_type& operator=(winrt::handle_type&& other) noexcept;
Parâmetros
other
Um valor handle_type a ser atribuído ao objeto handle_type .
Valor retornado
Uma referência ao objeto handle_type .
função swap
Troca o conteúdo dos dois parâmetros handle_type para que eles contenham o identificador um do outro.
Sintaxe
void swap(winrt::handle_type& left, winrt::handle_type& right) noexcept;
Parâmetros
left
right
Um valor handle_type cujo identificador deve ser alternado mutuamente com o do outro parâmetro.
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários