winrt::event struct template (C++/WinRT)

  • Artikel

Jenis yang dapat Anda gunakan untuk mendeklarasikan dan mengimplementasikan peristiwa jenis delegasi tertentu. Pelanggan meneruskan delegasi penanganan peristiwa mereka ke suatu acara; peristiwa mendaftarkan delegasi tersebut dalam koleksi; kemudian, ketika dinaikkan, peristiwa memanggil delegasi terdaftar secara bergantian sehingga pelanggan dapat menangani peristiwa tersebut. Untuk informasi selengkapnya tentang penulisan peristiwa, dan contoh kode, lihat Menulis peristiwa di C++/WinRT.

Jika Anda memerlukan peristiwa internal untuk proyek Anda, dan tidak terbatas pada jenis Windows Runtime, gunakan event<winrt::d elegate>. Untuk informasi selengkapnya, lihat Delegasi berparameter, sinyal sederhana, dan panggilan balik dalam proyek.

Untuk informasi selengkapnya tentang menangani peristiwa, dan contoh kode, lihat Menangani peristiwa dengan menggunakan delegasi di C++/WinRT.

Sintaks

template <typename Delegate>
struct event

Parameter templat

typename Delegate Jenis delegasi yang dapat mendaftar untuk menangani peristiwa.

Persyaratan

SDK minimum yang didukung: Windows SDK versi 10.0.17134.0 (Windows 10, versi 1803)

Namespace: winrt

Header: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (disertakan secara default)

Alias jenis anggota

Nama alias Jenis
event::d elegate_type Sinonim untuk typename Delegate parameter templat.

Konstruktor

Konstruktor Deskripsi
event::event constructor Menginisialisasi instans baru dari struktur peristiwa .

Fungsi anggota

Fungsi Deskripsi
event::add function Mendaftarkan delegasi dengan objek peristiwa .
event::remove function Mencabut pendaftaran delegasi dari objek peristiwa .

Operator anggota

Operator Deskripsi
event::operator() (operator panggilan fungsi) Memanggil semua delegasi terdaftar objek peristiwa dengan argumen yang disediakan.
event::operator bool Memeriksa apakah objek peristiwa memiliki delegasi yang terdaftar di dalamnya.

event::event constructor

Menginisialisasi instans baru dari struktur peristiwa .

Sintaks

event();

event::add function

Mendaftarkan delegasi dengan objek peristiwa .

Sintaks

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

Parameter

delegate Delegasi untuk mendaftar dengan objek peristiwa .

Mengembalikan nilai

Winrt::event_token yang kemudian dapat digunakan untuk mencabut pendaftaran delegasi.

event::operator() (operator panggilan fungsi)

Memanggil semua delegasi terdaftar objek peristiwa dengan argumen yang disediakan.

Sintaks

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

Parameter templat

typename... Arg Paket parameter templat variadik yang berisi jenis parameter yang diteruskan delegasi saat dipanggil.

Parameter

args Daftar argumen variabel yang berisi argumen yang diteruskan delegasi saat dipanggil.

event::operator bool

Memeriksa apakah objek peristiwa memiliki delegasi yang terdaftar di dalamnya.

Sintaks

explicit operator bool() const noexcept;

Mengembalikan nilai

true jika objek peristiwa memiliki delegasi terdaftar, jika tidak false.

event::remove function

Mencabut pendaftaran delegasi dari objek peristiwa .

Sintaks

void remove(winrt::event_token const token);

Parameter

tokenWinrt::event_token yang mengidentifikasi delegasi yang pendaftarannya akan dicabut.

Lihat juga