Übersicht über Steuerelementereignisse
Steuerelementereignisse entsprechen Microsoft Windows-Nachrichten in Win32-basierten Anwendungen. Anstatt jedoch eine Rückruffunktion zu erstellen, um Windows-Nachrichten zu empfangen und mit der SendMessage-Funktion zu senden, veröffentlichen das Installationsprogramm der Benutzeroberfläche und die Steuerelemente Steuerelementereignisse (ControlEvents). Andere Steuerelemente und das Installationsprogramm können bestimmte Steuerelementereignisse abonnieren, die dann die Attribute des abonnierenden Steuerelements ändern. Um Dialogfeldern funktionierende Steuerelemente hinzuzufügen, geben Ersteller*innen der Benutzeroberfläche die Veröffentlichung von Steuerelementereignissen in der Tabelle ControlEvent an und legen in der Tabelle EventMapping Steuerelemente fest, die diese Steuerelementereignisse abonnieren.
Das Installationsprogramm veröffentlicht die folgenden Ereignisse für das Abonnieren von Steuerelementen, die in der Tabelle EventMapping aufgeführt sind. Ein ProgressBar-Steuerelement oder ein Billboard-Steuerelement abonniert in der Regel SetProgress, die übrigen werden von Text-Steuerelementen abonniert.
ActionData-Steuerelementereignis
ActionText-Steuerelementereignis
SetProgress-Steuerelementereignis
TimeRemaining-Steuerelementereignis
ScriptInProgress-Steuerelementereignis
Die folgenden Ereignisse werden vom Steuerelement veröffentlicht, wenn die Elementauswahl in ein SelectionTree-Steuerelement oder ein DirectoryList-Steuerelement verschoben wird. Die abonnierenden Steuerelemente müssen sich im selben Dialogfeld befinden und in der Tabelle „EventMapping“ aufgeführt sein.
IgnoreChange-Steuerelementereignis
SelectionDescription-Steuerelementereignis
SelectionSize-Steuerelementereignis
SelectionPath-Steuerelementereignis
SelectionAction-Steuerelementereignis
SelectionNoItems-Steuerelementereignis
Die folgenden Steuerelementereignisse können im Ermessen von Benutzer*innen veröffentlicht werden, indem sie mit einem PushButton-Steuerelement oder CheckBox-Steuerelement in einem Dialogfeld interagieren. Das CheckBox-Steuerelement kann nur die Ereignisse „AddLocal“, „AddSource“, „Remove“, „DoAction“ und „SetProperty“ veröffentlichen. Mit Windows Installer-Versionen, die mit Windows Server 2003 und höher ausgeliefert wurden, kann das SelectionTree-Steuerelement die Steuerelementereignisse „DoAction“ und „SetProperty“ veröffentlichen. Ersteller*innen einer Benutzeroberfläche sollten Steuerelementereignisse in der Tabelle ControlEvent auflisten. Der Benutzeroberflächenhandler des Installationsprogramms ist der Abonnent dieser Ereignisse.
AddLocal-Steuerelementereignis
AddSource-Steuerelementereignis
CheckExistingTargetPath-Steuerelementereignis
CheckTargetPath-Steuerelementereignis
DoAction-Steuerelementereignis
EnableRollback-Steuerelementereignis
EndDialog-Steuerelementereignis
NewDialog-Steuerelementereignis
Reinstall-Steuerelementereignis
ReinstallMode-Steuerelementereignis
SetInstallLevel-Steuerelementereignis
SetProperty-Steuerelementereignis
SetTargetPath-Steuerelementereignis
SpawnDialog-Steuerelementereignis
SpawnWaitDialog-Steuerelementereignis
ValidateProductID-Steuerelementereignis
Ein PushButton-Steuerelement kann die folgenden Ereignisse in einem abonnierenden SelectionTree-Steuerelement oder DirectoryList-Steuerelement veröffentlichen, das sich im selben Dialogfeld befindet. Das PushButton-Steuerelement sollte in der Tabelle „ControlEvent“ und die abonnierenden Steuerelemente sollten in der Tabelle „EventMapping“ aufgeführt werden.
SelectionBrowse-Steuerelementereignis
DirectoryListUp-Steuerelementereignis
DirectoryListNew-Steuerelementereignis
DirectoryListOpen-Steuerelementereignis
Steuerelementereignisse erfordern in der Regel, dass die Benutzeroberfläche auf der Ebene vollständige Benutzeroberfläche ausgeführt wird. Die meisten Steuerelementereignisse funktionieren nicht mit einer reduzierten Benutzeroberfläche oder einer einfachen Benutzeroberfläche, da auf diesen Ebenen nur moduslose Dialogfelder angezeigt werden. Die Ereignisse „ActionText“, „AddSource“, „SetProgress“, „TimeRemaining“ und „ScriptInProgress“ sind hierzu Ausnahmen, die auch auf einer reduzierten oder einfachen Benutzeroberfläche funktionieren. Weitere Informationen zu Benutzeroberflächenebenen finden Sie unter Benutzeroberflächenebenen.
Sie können benutzerdefinierte Aktionen ausführen, indem Sie ein Steuerelementereignis über ein PushButton-Steuerelement oder ein CheckBox-Steuerelement veröffentlichen. Fügen Sie der Tabelle ControlEvent einen Eintrag mit den Namen des Dialogfelds und des Steuerelements hinzu, das das Steuerelementereignis veröffentlicht. Dieses Steuerelement sollte ein DoAction-Steuerelementereignis veröffentlichen, das das Installationsprogramm anweist, die benutzerdefinierte Aktion auszuführen. Unter Windows XP oder älteren Systemen können Sie keine benutzerdefinierte Aktion ausführen, indem Sie ein Steuerelementereignis aus einem SelectionTree-Steuerelement veröffentlichen.
Weitere Informationen zu bestimmten Steuerelementereignissen finden Sie in der Liste der Standardsteuerelementereignisse in der Referenz zur Benutzeroberfläche.