Общие сведения о ControlEvent
События ControlEvent аналогичны сообщениям Microsoft Windows в приложениях на основе Win32. Однако вместо создания функции обратного вызова для получения сообщений Windows и отправки сообщений Windows с помощью функции SendMessage установщик пользовательского интерфейса и элементы управления опубликуют ControlEvents. Другие элементы управления и установщик можно указать для подписки на определенные события ControlEvent, которые затем изменят атрибуты подписывающегося элемента управления. Чтобы добавить рабочие элементы управления в диалоговые окна, автор пользовательского интерфейса указывает публикацию ControlEvents в таблице ControlEvent и подписывает элементы управления на ControlEvents в таблице EventMapping.
Установщик опубликует следующие события в элементах управления подписки, перечисленных в таблице EventMapping. Элемент управления ProgressBar или Элемент управления Billboard обычно подписывается на SetProgress, остальные подписываются элементами управления Text.
Следующие события публикуются элементом управления при перемещении выбранного элемента в элемент управления SelectionTree или Элемент управления DirectoryList. Элементы управления подпиской должны находиться в том же диалоговом окне и перечислены в таблице EventMapping.
SelectionDescription ControlEvent
Следующие события ControlEvents можно опубликовать по усмотрению пользователя, взаимодействуя с элементом управления PushButton или Элементом управления CheckBox в диалоговом окне. Элемент управления Checkbox может публиковать только события AddLocal, AddSource, Remove, DoAction и SetProperty. В версиях установщика Windows, поставляемых с Windows Server 2003 и более поздних версий, элемент управления SelectionTree может публиковать события DoAction, ControlEvent и SetProperty ControlEvent. Автор пользовательского интерфейса должен перечислить ControlEvent в таблице ControlEvent. Обработчик пользовательского интерфейса установщика является подписчиком этих событий.
CheckExistingTargetPath ControlEvent
Сброс элемента управленияEvent
ValidateProductID ControlEvent
Элемент управления PushButton может публиковать следующие события в подписывшемся элементе управления SelectionTree или элементе управления DirectoryList, расположенном в том же диалоговом окне. Элемент управления PushButton должен быть указан в таблице ControlEvent, а элементы управления подписки — в таблице EventMapping.
DirectoryListОткрытие элемента управленияEvent
События элемента управления обычно требуют, чтобы пользовательский интерфейс выполнялся на полном уровне пользовательского интерфейса . Большинство событий ControlEvent не будут работать с сокращенным пользовательским интерфейсом или базовым пользовательским интерфейсом , так как на этих уровнях отображаются только немодированные диалоговые окна. События ActionText, AddSource, SetProgress, TimeRemaining и ScriptInProgress являются исключениями и будут работать в сокращенном или простом пользовательском интерфейсе. Дополнительные сведения об уровнях пользовательского интерфейса см. в разделе Уровни пользовательского интерфейса.
Вы можете выполнять пользовательские действия , опубликовав controlEvent из элемента управления PushButton или элемента управления Checkbox. Добавьте запись в таблицу ControlEvent с именами диалогового окна и элемента управления, публикующего ControlEvent. Этот элемент управления должен опубликовать doAction ControlEvent , уведомляющее установщик о выполнении настраиваемого действия. В Windows XP или более ранних версиях нельзя выполнить настраиваемое действие, опубликовав controlEvent из элемента управления SelectionTree.
Дополнительные сведения о конкретных событиях ControlEvent см. в списке стандартных событий ControlEvents в справочнике по пользовательскому интерфейсу.