Общие сведения о ControlEvent

События ControlEvent аналогичны сообщениям Microsoft Windows в приложениях на основе Win32. Однако вместо создания функции обратного вызова для получения сообщений Windows и отправки сообщений Windows с помощью функции SendMessage установщик пользовательского интерфейса и элементы управления опубликуют ControlEvents. Другие элементы управления и установщик можно указать для подписки на определенные события ControlEvent, которые затем изменят атрибуты подписывающегося элемента управления. Чтобы добавить рабочие элементы управления в диалоговые окна, автор пользовательского интерфейса указывает публикацию ControlEvents в таблице ControlEvent и подписывает элементы управления на ControlEvents в таблице EventMapping.

Установщик опубликует следующие события в элементах управления подписки, перечисленных в таблице EventMapping. Элемент управления ProgressBar или Элемент управления Billboard обычно подписывается на SetProgress, остальные подписываются элементами управления Text.

ActionData ControlEvent

ActionText ControlEvent

SetProgress ControlEvent

TimeRemaining ControlEvent

ScriptInProgress ControlEvent

Следующие события публикуются элементом управления при перемещении выбранного элемента в элемент управления SelectionTree или Элемент управления DirectoryList. Элементы управления подпиской должны находиться в том же диалоговом окне и перечислены в таблице EventMapping.

IgnoreChange ControlEvent

SelectionDescription ControlEvent

SelectionSize ControlEvent

SelectionPath ControlEvent

SelectionAction ControlEvent

SelectionNoItems ControlEvent

Следующие события ControlEvents можно опубликовать по усмотрению пользователя, взаимодействуя с элементом управления PushButton или Элементом управления CheckBox в диалоговом окне. Элемент управления Checkbox может публиковать только события AddLocal, AddSource, Remove, DoAction и SetProperty. В версиях установщика Windows, поставляемых с Windows Server 2003 и более поздних версий, элемент управления SelectionTree может публиковать события DoAction, ControlEvent и SetProperty ControlEvent. Автор пользовательского интерфейса должен перечислить ControlEvent в таблице ControlEvent. Обработчик пользовательского интерфейса установщика является подписчиком этих событий.

AddLocal ControlEvent

AddSource ControlEvent

CheckExistingTargetPath ControlEvent

CheckTargetPath ControlEvent

DoAction ControlEvent

EnableRollback ControlEvent

EndDialog ControlEvent

NewDialog ControlEvent

Переустановка ControlEvent

ReinstallMode ControlEvent

Удаление ControlEvent

Сброс элемента управленияEvent

SetInstallLevel ControlEvent

SetProperty ControlEvent

SetTargetPath ControlEvent

SpawnDialog ControlEvent

SpawnWaitDialog ControlEvent

ValidateProductID ControlEvent

Элемент управления PushButton может публиковать следующие события в подписывшемся элементе управления SelectionTree или элементе управления DirectoryList, расположенном в том же диалоговом окне. Элемент управления PushButton должен быть указан в таблице ControlEvent, а элементы управления подписки — в таблице EventMapping.

SelectionBrowse ControlEvent

DirectoryListUp ControlEvent

DirectoryListNew ControlEvent

DirectoryListОткрытие элемента управленияEvent

События элемента управления обычно требуют, чтобы пользовательский интерфейс выполнялся на полном уровне пользовательского интерфейса . Большинство событий ControlEvent не будут работать с сокращенным пользовательским интерфейсом или базовым пользовательским интерфейсом , так как на этих уровнях отображаются только немодированные диалоговые окна. События ActionText, AddSource, SetProgress, TimeRemaining и ScriptInProgress являются исключениями и будут работать в сокращенном или простом пользовательском интерфейсе. Дополнительные сведения об уровнях пользовательского интерфейса см. в разделе Уровни пользовательского интерфейса.

Вы можете выполнять пользовательские действия , опубликовав controlEvent из элемента управления PushButton или элемента управления Checkbox. Добавьте запись в таблицу ControlEvent с именами диалогового окна и элемента управления, публикующего ControlEvent. Этот элемент управления должен опубликовать doAction ControlEvent , уведомляющее установщик о выполнении настраиваемого действия. В Windows XP или более ранних версиях нельзя выполнить настраиваемое действие, опубликовав controlEvent из элемента управления SelectionTree.

Дополнительные сведения о конкретных событиях ControlEvent см. в списке стандартных событий ControlEvents в справочнике по пользовательскому интерфейсу.