Gambaran Umum ControlEvent
ControlEvents dianalogikan dengan pesan Microsoft Windows di aplikasi berbasis Win32. Namun, daripada membuat fungsi panggilan balik untuk menerima pesan Windows dan mengirim pesan Windows dengan fungsi SendMessage, penginstal antarmuka pengguna (UI) dan kontrol menerbitkan ControlEvents. Kontrol lain dan alat penginstal dapat ditentukan untuk berlangganan ControlEvents tertentu yang kemudian akan mengubah atribut kontrol berlangganan. Untuk menambahkan kontrol kerja ke kotak dialog, penulis UI menentukan publikasi ControlEvents dalam tabel ControlEvent dan berlangganan kontrol ke ControlEvents dalam tabel EventMapping.
Alat penginstal akan menerbitkan peristiwa berikut untuk berlangganan kontrol yang tercantum dalam tabel EventMapping. Kontrol ProgressBar atau kontrol Billboard biasanya berlangganan SetProgress, sisanya dilanggani oleh kontrol Teks.
Peristiwa berikut diterbitkan oleh kontrol saat pilihan item dipindahkan dalam kontrol SelectionTree atau Kontrol DirectoryList. Kontrol berlangganan harus terletak pada kotak dialog yang sama dan tercantum dalam tabel EventMapping.
SelectionDescription ControlEvent
ControlEvents berikut ini dapat diterbitkan atas kebijakan pengguna dengan berinteraksi dengan kontrol PushButton atau kontrol Kotak Centang pada kotak dialog. Kontrol Kotak Centang hanya dapat menerbitkan peristiwa AddLocal, AddSource, Remove, DoAction, dan SetProperty. Dengan versi Pemasang Windows yang dikirim dengan Windows Server 2003 dan yang lebih baru, kontrol SelectionTree dapat menerbitkan DoAction, ControlEvent, dan SetProperty ControlEvents. Penulis UI harus mencantumkan ControlEvent dalam tabel ControlEvent. Handler UI alat penginstal adalah pelanggan untuk peristiwa ini.
CheckExistingTargetPath ControlEvent
Mengaktifkan ControlEventRollback
ValidateProductID ControlEvent
Kontrol PushButton dapat menerbitkan peristiwa berikut ke kontrol SelectionTree berlangganan atau kontrol DirectoryList yang terletak di kotak dialog yang sama. Kontrol PushButton harus tercantum dalam tabel ControlEvent dan kontrol berlangganan harus dicantumkan dalam tabel EventMapping.
DirectoryListKontrol BaruEvent
DirectoryListBuka ControlEvent
Peristiwa kontrol umumnya mengharuskan UI dijalankan pada tingkat UI penuh . Sebagian besar ControlEvents tidak akan berfungsi dengan UI yang dikurangi atau antarmuka pengguna dasar karena tingkat ini hanya menampilkan kotak dialog tanpa mode. Peristiwa ActionText, AddSource, SetProgress, TimeRemaining, dan ScriptInProgress adalah pengecualian dan akan berfungsi di UI yang berkurang atau dasar. Untuk informasi selengkapnya tentang tingkat antarmuka pengguna, lihat Tingkat Antarmuka Pengguna.
Anda dapat menjalankan tindakan kustom dengan menerbitkan ControlEvent dari kontrol PushButton atau kontrol Kotak Centang. Tambahkan rekaman ke tabel ControlEvent dengan nama dialog dan kontrol yang menerbitkan ControlEvent. Kontrol ini harus menerbitkan DoAction ControlEvent yang memberi tahu alat penginstal untuk menjalankan tindakan kustom. Pada Windows XP atau sistem yang lebih lama, Anda tidak dapat menjalankan tindakan kustom dengan menerbitkan ControlEvent dari kontrol SelectionTree.
Untuk informasi selengkapnya tentang ControlEvents tertentu, lihat daftar ControlEvents standar di Referensi Antarmuka Pengguna.