winrt::event struct template (C++/WinRT)
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.