Ü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

Remove-Steuerelementereignis

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