Plantilla de estructura winrt::event (C++/WinRT)

  • Artículo

Tipo que puede usar para declarar e implementar un evento de un tipo delegado especificado. Los suscriptores pasan sus delegados de control de eventos a un evento; el evento registra esos delegados en una colección; después, cuando se genera, el evento invoca a sus delegados registrados a su vez para que los suscriptores puedan controlar el evento. Para obtener más información sobre la creación de eventos y ejemplos de código, consulta Crear eventos en C++/WinRT.

Si necesita eventos internos en el proyecto y no se limita a Windows Runtime tipos, use eventwinrt<::d elegate>. Para obtener más información, consulta Delegados con parámetros, señales simples y devoluciones de llamada dentro de un proyecto.

Para obtener más información sobre cómo controlar eventos y ejemplos de código, consulta Controlar eventos mediante delegados en C++/WinRT.

Sintaxis

template <typename Delegate>
struct event

Parámetros de plantilla

typename Delegate Tipo de delegado que se puede registrar para controlar el evento.

Requisitos

SDK mínimo admitido: sdk de Windows versión 10.0.17134.0 (Windows 10, versión 1803)

Espacio de nombres: winrt

Encabezado: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluido de forma predeterminada)

Alias de tipo de miembro

Nombre de alias Tipo
event::d elegate_type Sinónimo del parámetro de typename Delegate plantilla.

Constructores

Constructor Descripción
event::event (Constructor) Inicializa una nueva instancia de la estructura de eventos .

Funciones miembro

Función Descripción
event::add (función) Registra un delegado con el objeto de evento .
event::remove (función) Revoca el registro de un delegado del objeto de evento .

Operadores de miembro

Operator Descripción
event::operator() (operador de llamada de función) Invoca todos los delegados registrados del objeto de evento con los argumentos proporcionados.
event::operator bool Comprueba si el objeto de evento tiene delegados registrados en él.

event::event (Constructor)

Inicializa una nueva instancia de la estructura de eventos .

Sintaxis

event();

event::add (función)

Registra un delegado con el objeto de evento .

Sintaxis

winrt::event_token add(Delegate const& delegate);

Parámetros

delegate Delegado que se va a registrar con el objeto de evento .

Valor devuelto

Winrt::event_token que se puede usar posteriormente para revocar el registro del delegado.

event::operator() (operador de llamada de función)

Invoca todos los delegados registrados del objeto de evento con los argumentos proporcionados.

Sintaxis

template<typename... Arg>
void operator()(Arg const&... args)

Parámetros de plantilla

typename... Arg Paquete de parámetros de plantilla variádica que contiene los tipos de los parámetros que el delegado se pasa cuando se llama a él.

Parámetros

args Lista de argumentos variables que contiene los argumentos que el delegado se pasa cuando se llama a él.

event::operator bool

Comprueba si el objeto de evento tiene delegados registrados en él.

Sintaxis

explicit operator bool() const noexcept;

Valor devuelto

true es si el objeto de evento tiene delegados registrados; de lo contrario false, es .

event::remove (función)

Revoca el registro de un delegado del objeto de evento .

Sintaxis

void remove(winrt::event_token const token);

Parámetros

tokenWinrt::event_token que identifica el delegado cuyo registro se va a revocar.

Consulte también