Hinzufügen von Steuerelementen und Text

Steuerelemente und Text, die auf Dialogfeldern und Billboards platziert werden, ermöglichen es dem Benutzer, mit dem Installationsprozess zu interagieren. Fügen Sie der Benutzeroberfläche ein Dialogfeld hinzu, indem Sie es in die Dialogtabelle einfügen, wie unter Verwenden der Benutzeroberfläche beschrieben. Füllen Sie Dialogfelder und Billboards mit Steuerelementen aus, indem Sie die Tabelle Control bzw. BBControl auffüllen.

Die anfänglichen Attribute des Steuerelements können in der Spalte Attribute der Tabelle Control angegeben werden. Weitere Informationen finden Sie unter Steuerelementattribute.

Um Steuerelementattribute von einer Bedingung abhängig zu machen, verwenden Sie die Tabelle ControlCondition , um ein Steuerelement entsprechend dem Wert einer Eigenschaft oder bedingten Anweisung zu deaktivieren, zu aktivieren, auszublenden oder anzuzeigen. Sie können diese Tabelle auch verwenden, um die Spezifikation des Standardsteuerelements zu überschreiben, das in die Tabelle Dialog eingegeben wurde.

Wenn ein Ereignis ein Steuerelementattribut ändert, abonnieren Sie das Steuerelement für ein ControlEvent in der Tabelle EventMapping. Ein ControlEvent gibt eine Aktion an, die vom Installer ausgeführt werden soll, oder eine Änderung der Attribute eines oder mehrerer Steuerelemente in einem Dialogfeld. Weitere Informationen finden Sie unter Übersicht ControlEvent. Geben Sie den Bezeichner des Attributs in die Spalte Attribute und den Bezeichner des Ereignisses in die Spalte Event der Tabelle EventMapping ein.

Einige Steuerelemente erleichtern das Sammeln von Informationen vom Benutzer. Mit einem Kontrollkästchen kann der Benutzer beispielsweise den Wert einer Eigenschaft festlegen. Weitere Informationen finden Sie unter Tabelle CheckBox, Tabelle ComboBox, Tabelle ListBox, Tabelle RadioButton und Tabelle ListView.

Aus Sicherheitsgründen können private Eigenschaften nicht von einem Benutzer durch Interaktion mit der Benutzeroberfläche geändert werden. Wenn eine Eigenschaft von der Benutzeroberfläche festgelegt werden soll, muss sie eine öffentliche Eigenschaft sein und einen Namen in Großbuchstaben aufweisen. Weitere Informationen finden Sie unter Informationen zu Eigenschaften.

Sie können entweder festlegen, dass das Dialogfeld Informationen für den Benutzer darstellt, oder es als Reaktion auf Installationsaktionen in ein Protokoll schreiben, indem Sie die Tabelle ActionText ausfüllen.

Steuerelemente können über einen vordefinierten Schriftschnitt verfügen. Um die Schriftart und den Schriftschnitt einer Textzeichenfolge festzulegen, stellen Sie der Zeichenfolge der angezeigten Zeichen {\style} oder {&style} voran. Dabei ist „style“ ein Bezeichner, der in der TextStyle-Spalte der TextStyle-Tabelle aufgeführt ist. Wenn keines dieser Elemente vorhanden ist, aber die Eigenschaft DefaultUIFont als gültiger Textstil definiert ist, wird diese Schriftart verwendet.

Es wird empfohlen, die Eigenschaft DefaultUIFont jedes Installationspakets mit einer Benutzeroberfläche in der Tabelle Property auf einen der vordefinierten Stile festzulegen, die in der Tabelle TextStyle aufgeführt sind. Wenn diese Eigenschaft nicht angegeben wird, verwendet der Installer die Systemschriftart. Dies kann dazu führen, dass der Installer Textzeichenfolgen nicht korrekt anzeigt, wenn sich die Codepage des Pakets von der Codepage der Standardbenutzeroberfläche der Benutzer unterscheidet.

Bei den meisten Steuerelementen wird Text mithilfe des Zeichensatzes angezeigt, der von der Codepage der Datenbank angegeben wird. Dadurch wird sichergestellt, dass der richtige Zeichensatz mit den in der Datenbank enthaltenen Informationen verwendet wird. Ausnahmen hiervon sind die Steuerelemente Edit, DirectoryList, PathEdit und DirectoryCombo , die Text immer mit dem Standardzeichensatz der Benutzeroberfläche des Benutzers anzeigen. Die Steuerelemente Text, ListBox und ComboBox verwenden den Standardzeichensatz der Benutzeroberflächen, wenn das Steuerelementattribute UsersLanguage festgelegt ist.

In einigen Fällen wird ein Steuerelement möglicherweise nicht richtig neu gezeichnet, wenn ein Dialogfeld über Abbrechen geschlossen wird. Dies hat mit der Reihenfolge zu tun, in der die Steuerelemente WM_PAINT-Nachrichten empfangen, nachdem das Dialogfeld über Abbrechen geschlossen wurde. Versuchen Sie, die Reihenfolge der Steuerelemente in der Control-Tabelle zu ändern, um dies zu korrigieren.

Steuerelemente sollten groß genug sein, um den gesamten Text aufzunehmen, der bei allen Einstellungen für den Schriftgrad angezeigt wird. Steuerelemente sollten groß genug sein, um den gesamten lokalisierten Text aufzunehmen, wenn der Text auf der Benutzeroberfläche lokalisiert werden soll. Größere Schriftgrade oder lokalisierter Text erfordern möglicherweise mehr Platz als der ursprüngliche Text und können durch ein zu kleines Steuerelement abgeschnitten werden. Weitere Informationen zum Lokalisieren von Benutzeroberflächentext finden Sie im Abschnitt: Ein Lokalisierungsbeispiel.