Dialogfelder (Windows Installer)

  • Artikel

Dialogfelder werden in der Spalte „Dialog“ der Tabelle Dialog angegeben. Weitere Informationen zum Hinzufügen eines Dialogfelds oder einem Billboard zu einer Benutzeroberfläche finden Sie unter Verwenden der Benutzeroberfläche.

Reservierte Dialogfeldnamen

Die folgenden Dialogfeldnamen sind für Windows Installer reserviert und dürfen nicht für benutzerseitig erstellte Dialogfelder verwendet werden. Das Installationsprogramm erfordert, dass diese Dialogfelder in der Tabelle Dialog mit den folgenden reservierten Namen aufgeführt werden. Jedes Dialogfeld und jeder Name kann nur einmal aufgeführt werden. Entwickler*innen müssen diese Dialogfelder in der Benutzeroberfläche erstellen. Informationen zum Anzeigen einer Vorschau von Dialogfeldern finden Sie unter Importieren der Benutzeroberfläche.

Dialogfeldname Kurzbeschreibung des Dialogfelds
Dialogfeld FilesInUse Warnt Benutzer*innen, wenn Dateien überschrieben oder gelöscht werden.
Dialogfeld FirstRun Erfasst Benutzername, Firmenname und Produkt-ID.
Dialogfeld MsiRMFilesInUse Warnt Benutzer*innen, wenn Dateien überschrieben oder gelöscht werden, und gibt ihnen die Möglichkeit, Anwendungen über den Neustart-Manager zu schließen und neu zu starten.

 

Erforderliche Dialogfelder

Während der Installation führen bestimmte Ereignisse dazu, dass Windows Installer die Sequenztabellen der Benutzeroberfläche im Paket überprüft und das angegebene Dialogfeld anzeigt. Bei einem schwerwiegenden Fehler zeigt Windows Installer beispielsweise das Dialogfeld an, das in der Sequenztabelle der Benutzeroberfläche mit der Sequenznummer -3 aufgeführt ist, unabhängig davon, wie dieses Dialogfeld in der Tabelle Dialog benannt ist. In der folgenden Tabelle sind die spezifischen Ereignisse mit der jeweiligen Sequenznummer in der Sequenztabelle der Benutzeroberfläche aufgeführt:

Typ des Ereignisses Sequenznummer in der Sequenztabelle der Benutzerschnittstelle Beschreibung des Dialogfelds
Schwerwiegender Fehler -3 Die Installation wurde durch einen schwerwiegenden Fehler abgebrochen.
Beendung durch Benutzer*in -2 Die Installation wurde auf Anforderung des Benutzers bzw. der Benutzerin beendet.
Beenden -1 Die Installation wurde erfolgreich abgeschlossen.

 

Darüber hinaus muss der/die Paketersteller*in ein generisches Dialogfeld erstellen, um Windows Installer-Fehlermeldungen anzuzeigen. Dieses Dialogfeld kann einen beliebigen Namen haben, dieser Name muss jedoch in der ErrorDialog-Eigenschaft angegeben werden.

Typische Dialogfelder

Die folgenden Dialogfelder sind optional und häufig in der erstellten Benutzeroberfläche eines Installationspakets enthalten. Diese Dialogfelder sind typisch für die meisten Benutzeroberflächen-Assistenten zum Installieren von Dateien. Diese Dialogfelder können in der Dialogtabelle einen beliebigen Namen aufweisen. Die angegebenen Namen werden nur aus Gründen der Übersichtlichkeit empfohlen und können bei Bedarf geändert werden. Beispielsweise können zwei verschiedene benutzerdefinierte Dialogfelder LicenseAgreement im Paket verwendet und in der Tabelle „Dialog“ durch die Namen „ProfessionalLicenseAgreement“ und „LimitedLicenseAgreement“ unterschieden werden.

Typ des Dialogfelds Kurzbeschreibung des Dialogfelds
Dialogfeld DiskCost Gibt an, dass nicht genügend Speicherplatz für die Installation vorhanden ist.
Durchsuchen des Dialogfelds Ermöglicht es Benutzer*innen, ein Verzeichnis auszuwählen.
Dialogfeld Cancel Bestätigt eine Anforderung zum Abbrechen der Installation.
Dialogfeld License agreement Modales Feld, in dem die Lizenzvereinbarung angezeigt wird.
Dialogfeld Selection Modales Feld, in dem Benutzer*innen Elemente auswählen können.