Control-Tabelle
Die Control-Tabelle definiert die Steuerelemente, die in den einzelnen Dialogfeldern angezeigt werden.
Die Control-Tabelle enthält die folgenden Spalten.
| Spalte | Typ | Schlüssel | Nullwerte zulässig |
|---|---|---|---|
| Dialog_ | Identifier | J | N |
| Control | Identifier | J | N |
| type | Identifier | N | N |
| X | Integer | N | N |
| J | Integer | N | N |
| Breite | Integer | N | N |
| Höhe | Integer | N | N |
| Attribute | DoubleInteger | N | J |
| Eigenschaft | Identifier | N | J |
| Text | Formatted | N | J |
| Control_Next | Identifier | N | J |
| Hilfe | Text | N | J |
Spalten
-
Dialog_
-
Externer Schlüssel für die erste Spalte der Dialog-Tabelle, der Name des Dialogfelds.
-
Control
-
Name des Steuerelements. Dieser Name muss innerhalb eines Dialogfelds eindeutig sein, kann aber in verschiedenen Dialogfeldern wiederholt werden. Die Control-Spalte bildet zusammen mit der Dialog_-Spalte den Primärschlüssel für diese Tabelle.
-
Type
-
Der Typ des Steuerelements. Eine Liste der Steuerelementtypen finden Sie unter Steuerelemente.
-
X
-
Horizontale Koordinate der oberen linken Ecke der rechteckigen Begrenzung des Steuerelements. Dieser Wert muss eine nicht negative Zahl sein. Weitere Informationen finden Sie unter Position-Steuerelementattribute.
-
Y
-
Horizontale Koordinate der oberen linken Ecke der rechteckigen Begrenzung des Steuerelements. Dieser Wert muss eine nicht negative Zahl sein. Weitere Informationen finden Sie unter Position-Steuerelementattribute.
-
Width
-
Breite der rechteckigen Begrenzung des Steuerelements. Dieser Wert muss eine nicht negative Zahl sein. Weitere Informationen finden Sie unter Position-Steuerelementattribute.
-
Height
-
Höhe der rechteckigen Begrenzung des Steuerelements. Dieser Wert muss eine nicht negative Zahl sein. Weitere Informationen finden Sie unter Position-Steuerelementattribute.
-
Attributes
-
Ein 32-Bit-Wort, das die Bitflags angibt, die auf dieses Steuerelement angewendet werden sollen. Dieser Wert muss eine nicht negative Zahl sein, und die zulässigen Werte hängen vom Typ des Steuerelements ab. Eine Liste aller Steuerelementattribute und den Wert, der in dieses Feld eingegeben werden soll, finden Sie unter Steuerelementattribute.
-
Property
-
Der Name einer definierten Eigenschaft, die mit diesem Steuerelement verknüpft werden soll. Optionsfeld-, Listenfeld- und Kombinationsfeldwerte werden in einer Gruppe zusammengefasst, indem sie mit derselben Eigenschaft verknüpft werden. Diese Spalte ist für aktive Steuerelemente erforderlich.
-
Text
-
Eine lokalisierbare Zeichenfolge zum Festlegen des anfänglichen Texts, der in einem Steuerelement enthalten sein soll. Die Zeichenfolge kann auch eingebettete Eigenschaften enthalten. Die Syntax einer formatierten Zeichenfolge mit Eigenschaften finden Sie unter der MsiFormatRecord-Funktion. Geben Sie die Größe, Schriftart und Farbe des Texts an, indem Sie der Textzeichenfolge {\formatvorlage} voranstellen. „formatvorlage“ steht hierbei für eine Textformatvorlage, die in der TextStyle-Spalte der TextStyle-Tabelle erstellt wurde. Die Zeichenfolge wird abgeschnitten, wenn der Text zu lang ist und nicht in das Steuerelement passt. Die Textzeichenfolge darf leer sein.
Eine spezielle Erstellung der Formatted-Textzeichenfolge in diesem Feld ist erforderlich, wenn der Text von einem Textsteuerelement angezeigt werden soll, das sich in einem Dialogfeld mit dem TrackDiskpace-Attribut befindet. Dies ist der Fall, der durch Angabe des TrackDiskSpace-Dialogstilbits in den Attributen der Dialog-Tabelle festgelegt wird. Wenn in diesem Fall die Formatted-Zeichenfolge in der Text-Spalte der Control-Tabelle mit „[“ beginnt und mit „]“ endet, müssen Sie am Ende der Zeichenfolge ein Leerzeichen hinzufügen. Wenn „dlgTextFont“ beispielsweise eine Eigenschaft ist, die auf „{\DlgFontBold}“ festgelegt wird, ist für die formatierte Zeichenfolge „[DlgTextFont]MeinText[ProductName] “ das Leerzeichen am Ende nach der schließenden Klammer erforderlich. Dieses zusätzliche Leerzeichen wird vom Installer benötigt, damit der Text im Text-Steuerelement ordnungsgemäß angezeigt wird.
Sie können eine kurze beschreibende Textzeichenfolge für die Steuerelemente VolumeCostList, ListView, DirectoryList und SelectionTree eingeben. Dieser Text ist für Benutzer*innen nicht sichtbar, kann aber von Sprachausgaben als Beschreibung des Steuerelements gelesen werden.
Weitere Informationen finden Sie unter Barrierefreiheit.
-
Control_Next
-
Der Name eines anderen Steuerelements im selben Dialogfeld und ein externer Schlüssel für die zweite Spalte der Control-Tabelle. Wenn sich der Fokus im Dialogfeld auf dem Steuerelement in der Control-Spalte befindet, wird durch Drücken der TAB-TASTE der Fokus auf das Steuerelement verschoben, das in der Control_Next-Spalte aufgeführt ist. Daher wird diese Spalte verwendet, um die Aktivierreihenfolge der Steuerelemente im Dialogfeld anzugeben. Die Verknüpfungen zwischen den Steuerelementen müssen einen geschlossenen Zyklus bilden. Einige Steuerelemente, z. B. statische Textsteuerelemente, können aus dem Zyklus herausgelassen werden. In diesem Fall kann dieses Feld leer bleiben.
Weitere Informationen finden Sie unter Barrierefreiheit.
-
Hilfe
-
Optionale, lokalisierbare Textzeichenfolgen, die mit der Schaltfläche „Hilfe“ verwendet werden. Die Zeichenfolge ist in zwei Teile unterteilt, die durch ein Trennzeichen (|) getrennt sind. Der erste Teil der Zeichenfolge wird als QuickInfo-Text verwendet. Dieser Text wird von Sprachausgaben für Steuerelemente mit einem Bild verwendet. Der zweite Teil der Zeichenfolge ist für die zukünftige Verwendung reserviert. Das Trennzeichen ist auch dann erforderlich, wenn nur eine der beiden Textarten vorhanden ist.
Bemerkungen
Die ganzzahligen Werte für x, y, Width und Height werden in den Installationseinheiten und nicht in Dialogeinheiten angegeben. Eine Installationseinheit entspricht einem Zwölftel der Höhe des 10-Punkt-Schriftgrads der Schriftart „MS Sans Serif“. Koordinaten für die Steuerelemente sind relativ zum Billboard.
Überprüfen