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.

ActionData ControlEvent

ActionText ControlEvent

SetProgress ControlEvent

TimeRemaining ControlEvent

ScriptInProgress ControlEvent

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.

IgnoreChange ControlEvent

SelectionDescription ControlEvent

SelectionSize ControlEvent

SelectionPath ControlEvent

SelectionAction ControlEvent

SelectionNoItems 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.

AddLocal ControlEvent

AddSource ControlEvent

CheckExistingTargetPath ControlEvent

CheckTargetPath ControlEvent

DoAction ControlEvent

Mengaktifkan ControlEventRollback

EndDialog ControlEvent

NewDialog ControlEvent

Instal ulang ControlEvent

Instal ulangMode ControlEvent

Hapus ControlEvent

Reset ControlEvent

SetInstallLevel ControlEvent

SetProperty ControlEvent

SetTargetPath ControlEvent

SpawnDialog ControlEvent

SpawnWaitDialog ControlEvent

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.

SelectionBrowse ControlEvent

DirectoryListUp ControlEvent

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.