Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
ControlEvents zijn vergelijkbaar met Microsoft Windows-berichten in Win32-toepassingen. In plaats van een callback-functie te maken om Windows-berichten te ontvangen en Windows-berichten te verzenden met de functie SendMessage, publiceren de gebruikersinterface (UI) installatieprogramma en besturingselementen ControlEvents. Andere besturingselementen en de installer kunnen worden opgegeven om zich te abonneren op bepaalde ControlEvents, die vervolgens de attributen van het abonnerende besturingselement wijzigen. Als u werkende besturingselementen wilt toevoegen aan dialoogvensters, specificeert de auteur van de gebruikersinterface de publicatie van ControlEvents in de ControlEvent-tabel en schrijft besturingselementen in voor ControlEvents in de EventMapping-tabel.
Het installatieprogramma publiceert de volgende gebeurtenissen naar besturingselementen die zijn vermeld in de EventMapping-tabel. Een ProgressBar-controle of Billboard control abonneert doorgaans op SetProgress, de overige worden geabonneerd door tekstbesturingselementen.
De volgende gebeurtenissen worden door het besturingselement gepubliceerd wanneer de itemselectie wordt verplaatst in een SelectionTree-besturingselement of DirectoryList Control. Besturingselementen voor abonneren moeten zich in hetzelfde dialoogvenster bevinden en worden vermeld in de tabel EventMapping.
Selectiebeschrijving Besturingsevenement
SelectionNoItems ControleGebeurtenis
De volgende ControlEvents kunnen naar eigen goeddunken gepubliceerd worden door interactie met de PushButton-besturingselement of selectievakje in een dialoogvenster. Het besturingselement Selectievakje kan alleen de gebeurtenissen AddLocal, AddSource, Remove, DoAction en SetProperty publiceren. Met Windows Installer-versies die worden geleverd met Windows Server 2003 en hoger, kan het SelectionTree-besturingselement het DoAction-, ControlEvent- en SetProperty ControlEvents publiceren. De auteur van de gebruikersinterface moet de ControlEvent weergeven in de tabel ControlEvent. De UI-handler van het installatieprogramma is de ontvanger van deze gebeurtenissen.
CheckExistingTargetPath ControlEvent
ControlEvent opnieuw installeren
ControlEvent opnieuw instellen
ValidateProductID ControlEvent
Een PushButton-besturingselement kan de volgende gebeurtenissen publiceren naar een abonnement van een SelectionTree-besturingselement of een DirectoryList-besturingselement, dat zich in hetzelfde dialoogvenster bevindt. Het besturingselement PushButton moet worden vermeld in de tabel ControlEvent en de besturingselementen voor abonneren moeten worden vermeld in de tabel EventMapping.
SelectionBrowse ControlEvent -
DirectoryListOpen ControlEvent
Voor controle-gebeurtenissen is over het algemeen vereist dat de gebruikersinterface wordt uitgevoerd op het volledige niveau van de gebruikersinterface. De meeste ControlEvents werken niet met een gereduceerde UI of eenvoudige UI omdat deze niveaus alleen modeless dialoogvensters weergeven. De gebeurtenissen ActionText, AddSource, SetProgress, TimeRemaining en ScriptInProgress zijn uitzonderingen en werken in een beperkte of eenvoudige gebruikersinterface. Zie gebruikersinterfaceniveausvoor meer informatie over ui-niveaus.
U kunt aangepaste acties uitvoeren door een ControlEvent te publiceren vanuit een drukknopbesturingselement of selectievakbesturingselement. Voeg een record toe aan de ControlEvent-tabel met de namen van het dialoogvenster en het besturingselement dat de ControlEvent publiceert. "Dit besturingselement moet een DoAction ControlEvent publiceren om de installateur op de hoogte te stellen van het uitvoeren van de aangepaste actie." Op Windows XP- of eerdere systemen kunt u geen aangepaste actie uitvoeren door een ControlEvent te publiceren vanuit een SelectionTree-besturingselement.
Zie de lijst met standaard-ControlEvents in User Interface Referencevoor meer informatie over bepaalde ControlEvents.