Dialogfeld "Textfelder" der Benutzeroberfläche

Artikel
08/10/2011

Die Dialogfelder Textfelder werden verwendet, um dem Benutzer bis zu vier Auswahlmöglichkeiten zu bieten, und geben deren Inhalte während der Installation zurück. Es sind drei Dialogfelder vom Typ Textfelder verfügbar: Textfelder (A), Textfelder (B) und Textfelder (C). Diese drei Dialogfelder sind identisch. Jedes einzelne kann nur einmal je Bereitstellungsprojekt hinzugefügt werden.

Die Dialogfelder enthalten vier Textfelder mit den dazugehörigen Bezeichnungen sowie zusätzlichen Bezeichnungen zur Information des Benutzers. Der Text dieser Bezeichnungen wird beim Entwurf im Eigenschaftenfenster festgelegt. Jedes Textfeld enthält zusätzliche Eigenschaften zur Steuerung der Sichtbarkeit, zur Einstellung von Standardtexten und zur Rückgabe von Werten.

Die folgende Abbildung stellt das Dialogfeld Textfelder so dar, wie es während der Installation angezeigt wird.

Dialogfeld "Textfelder"

Begrüßungsbildschirm der Bereitstellungsbenutzeroberfläche

Eigenschaften

Folgende Eigenschaften stehen für das Dialogfeld Textfelder zur Verfügung:

Property	Beschreibungen
BannerBitmap	Gibt eine Bitmap- oder JPEG-Grafik an, die im Bannerbereich angezeigt werden soll. Die Abbildung oben zeigt die Standardbitmap. Weitere Informationen finden Sie unter BannerBitmap-Eigenschaft.
BannerText	Gibt den Text an, der im Bannerbereich angezeigt wird. In der oben gezeigten Abbildung wäre dies der Text "Dies ist der Bannertext".
BodyText	Gibt den Text an, der über den Textfeldern angezeigt wird. In der oben gezeigten Abbildung wäre dies der Text "Dies ist der Bannertext".
Edit1Label	Gibt den Text an, der neben dem ersten Textfeld angezeigt wird. In der oben gezeigten Abbildung wäre dies der Text "Erstes Eingabefeld".
Edit1Property	Gibt einen Eigenschaftennamen an, mit dem der in das erste Textfeld eingegebene Text abgerufen wird. Diese Eigenschaft kann bedingt verwendet werden.
Edit1Value	Gibt den Anfangswert (Text) des ersten Textfelds an.
Edit1Visible	Gibt an, ob das erste Textfeld sichtbar oder ausgeblendet sein soll. Bei einem Dialogfeld mit einem oder mehreren Textfeldern sollte true festgelegt werden.
Edit2Label	Gibt den Text an, der neben dem zweiten Textfeld angezeigt wird. In der oben gezeigten Abbildung wäre dies der Text "Zweites Eingabefeld".
Edit2Property	Gibt einen Eigenschaftennamen an, mit dem der in das zweite Textfeld eingegebene Text abgerufen wird. Diese Eigenschaft kann bedingt verwendet werden.
Edit2Value	Gibt den Anfangswert (Text) des zweiten Textfelds an.
Edit2Visible	Gibt an, ob das zweite Textfeld sichtbar oder ausgeblendet sein soll. Bei einem Dialogfeld mit zwei oder mehr Textfeldern sollte true festgelegt werden. Bei einem Dialogfeld, das nur ein einziges Textfeld anzeigt, sollte false festgelegt werden.
Edit3Label	Gibt den Text an, der neben dem dritten Textfeld angezeigt wird. In der oben gezeigten Abbildung wäre dies der Text "Drittes Eingabefeld".
Edit3Property	Gibt einen Eigenschaftennamen an, mit dem der in das dritte Textfeld eingegebene Text abgerufen wird. Diese Eigenschaft kann bedingt verwendet werden.
Edit3Value	Gibt den Anfangswert (Text) des dritten Textfelds an.
Edit3Visible	Gibt an, ob das dritte Textfeld sichtbar oder ausgeblendet sein soll. Bei einem Dialogfeld mit drei oder mehr Textfeldern sollte true festgelegt werden. Bei einem Dialogfeld, das zwei oder weniger Textfelder anzeigt, sollte false festgelegt werden.
Edit4Label	Gibt den Text an, der neben dem vierten Textfeld angezeigt wird. In der oben gezeigten Abbildung wäre dies der Text "Viertes Eingabefeld".
Edit4Property	Gibt einen Eigenschaftennamen an, mit dem der in das vierte Textfeld eingegebene Text abgerufen wird. Diese Eigenschaft kann bedingt verwendet werden.
Edit4Value	Gibt den Anfangswert (Text) des vierten Textfelds an.
Edit4Visible	Gibt an, ob das vierte Textfeld sichtbar oder ausgeblendet sein soll. Bei einem Dialogfeld mit vier Textfeldern sollte true festgelegt werden. Bei einem Dialogfeld, das drei oder weniger Textfelder anzeigt, sollte false festgelegt werden.

Festlegen der Darstellung des Dialogfelds "Textfelder"

Mehrere Eigenschaften steuern die Darstellung des Dialogfelds Textfelder während der Installation.

Die BannerBitmap-Eigenschaft steuert die Grafik, die in der rechten oberen Ecke des Dialogfelds angezeigt wird. Die Position und Größe der Grafik sind fest eingestellt.

Tipp

Zur konsistenten Gestaltung der Benutzeroberfläche sollte in einem Installationsprogramm für alle Dialogfelder dieselbe Grafik verwendet werden.
Die BannerText-Eigenschaft steuert den Bannertext, der oben im Dialogfeld angezeigt wird. Position, Größe und Schriftgrad sind fest eingestellt. Der Text wird zwar umbrochen, darf aber nicht länger als zwei Zeilen sein.
Die BodyText-Eigenschaft steuert den Text, der direkt unterhalb des Bannerbereichs des Dialogfelds angezeigt wird. Position, Größe und Schriftgrad sind fest eingestellt. Der Text wird zwar umbrochen, darf aber nicht länger als vier Zeilen sein.
Die EditNLabel-Eigenschaften steuern die Textanzeige in den Bezeichnungen der Textfelder. Position und Schriftgrad sind fest eingestellt. Der Text wird nicht umbrochen.

Tipp

Lassen Sie genügend Platz für Texterweiterungen, falls noch Dialogfelder lokalisiert werden. Bei Übersetzungen in andere Sprachen können Wörter unter Umständen viel länger sein, sodass der Text abgeschnitten werden könnte.

Abrufen von Benutzerinformationen mithilfe von Eigenschaften des Dialogfelds Textfelder

Wenn das Installationsprogramm mit dem Dialogfeld Textfelder ausgeführt wird, kann der Benutzer in jedem sichtbaren Textfeld Informationen eingeben. Diese Informationen können dann in einer anderen Phase der Installation genutzt werden.

Beispiel: Sie erstellen ein Dialogfeld Textfelder, in dem ein Benutzer einen Arbeitsgruppennamen eingeben kann, der in einem Registrierungseintrag gespeichert werden soll. In diesem Fall legen Sie die Edit1Label-Eigenschaft auf "Geben Sie Ihren Arbeitsgruppennamen ein" fest. Außerdem legen Sie die Eigenschaften Edit2Visible, Edit3Visible und Edit4Visible auf False fest, da Sie nur ein Textfeld benötigen.

Wenn Sie glauben, dass die Benutzer wahrscheinlich eine Arbeitsgruppe mit dem Namen "Standard" verwenden, können Sie den Wert Standard in der Edit1Value-Eigenschaft eingeben. Dies ist dann der Anfangseintrag, der dem Benutzer im Textfeld angezeigt wird.

Legen Sie dann in der Registrierung die Condition-Eigenschaft für den Registrierungseintrag des Arbeitsgruppennamens auf den Wert der Edit1Property-Eigenschaft fest, z. B. [EDITA1].

Während der Installation wird die Condition-Eigenschaft ausgewertet. Gibt der Benutzer einen Namen ein (oder akzeptiert er "Standard"), wird dieser Name der Registrierung hinzugefügt; bleibt das Feld leer, wird kein Registrierungseintrag erstellt.

Festlegen der Bedingung und des Werts für verwaltete benutzerdefinierte Aktionen

Wenn Sie für eine verwaltete benutzerdefinierte Aktion eine Benutzeroberfläche erstellen, können Sie die Bedingung und den Wert festlegen. Sie können die Bedingung und den Wert jedoch nur gemäß den benutzerdefinierten Benutzeroberflächeneigenschaften verwenden. Benutzerdefinierte Aktionen werden nach dem Abschluss des Installationsprogramms ausgeführt. Daher können Sie keine Eigenschaften aus dem Setupprojekt verwenden.