Steuerelementtabelle
Die Steuerelementtabelle definiert die Steuerelemente, die in jedem Dialogfeld angezeigt werden.
Die Steuerelementtabelle enthält die folgenden Spalten.
| Spalte | Art | Schlüssel | Nullable |
|---|---|---|---|
| Dialogfeld_ | Bezeichner | Y | N |
| Steuerung | Bezeichner | Y | N |
| Art | Bezeichner | N | N |
| X | ganze Zahl | N | N |
| Y | ganze Zahl | N | N |
| Breite | ganze Zahl | N | N |
| Höhe | ganze Zahl | N | N |
| Attribute | DoubleInteger- | N | Y |
| Eigentum | Bezeichner | N | Y |
| Text | formatierte | N | Y |
| Control_Next | Bezeichner | N | Y |
| Hilfe | N | Y |
Spalten
-
Dialog_
-
Externer Schlüssel zur ersten Spalte der Dialogtabelle, dem Namen des Dialogfelds.
-
-Steuerelement
-
Name des Steuerelements. Dieser Name muss innerhalb eines Dialogfelds eindeutig sein, kann aber in verschiedenen Dialogfeldern wiederholt werden. Die Steuerelementspalte in Kombination mit der Dialog_ Spalte bildet den Primärschlüssel für diese Tabelle.
-
Typ
-
Der Typ des Steuerelements. Eine Liste der Steuerelementtypen finden Sie unter Steuerelemente.
-
X
-
Horizontale Koordinate der oberen linken Ecke der rechteckigen Begrenzung des Steuerelements. Dies muss eine nicht negative Zahl sein. Siehe Positionssteuerelement-Attribut.
-
Y
-
Vertikale Koordinate der oberen linken Ecke des rechteckigen Rands des Steuerelements. Dies muss eine nicht negative Zahl sein. Siehe Positionssteuerelement-Attribut.
-
breite
-
Breite der rechteckigen Begrenzung des Steuerelements. Dies muss eine nicht negative Zahl sein. Siehe Positionssteuerelement-Attribut.
-
Höhe
-
Höhe der rechteckigen Begrenzung des Steuerelements. Dies muss eine nicht negative Zahl sein. Siehe Positionssteuerelement-Attribut.
-
Attribute
-
Ein 32-Bit-Wort, das die Bitkennzeichnungen angibt, die auf dieses Steuerelement angewendet werden sollen. Dies muss eine nicht negative Zahl sein, und die zulässigen Werte hängen vom Typ des Steuerelements ab. Eine Liste aller Steuerelementattribute und der wert, der in dieses Feld eingegeben werden soll, finden Sie unter Steuerelementattribute.
-
-Eigenschaft
-
Der Name einer definierten Eigenschaft, die mit diesem Steuerelement verknüpft werden soll. Optionsfeld-, Listenfeld- und Kombinationsfeldwerte sind an eine Gruppe gebunden, indem sie mit derselben Eigenschaft verknüpft werden. Diese Spalte ist für aktive Steuerelemente erforderlich.
-
Text
-
Eine lokalisierbare Zeichenfolge, die zum Festlegen des ursprünglichen Texts in einem Steuerelement verwendet wird. Die Zeichenfolge kann auch eingebettete Eigenschaften enthalten. Die Syntax einer formatierten Zeichenfolge, die Eigenschaften enthält, finden Sie in der funktion MsiFormatRecord. Geben Sie den Schriftgrad, die Schriftart und die Farbe des Texts an, indem Sie der Textzeichenfolge {\style} voranstellen. Dabei handelt es sich bei der Formatvorlage um eine Textformatvorlage, die in der Spalte "TextStyle" der TextStyle-Tabelle erstellt. Die Textzeichenfolge wird abgeschnitten, wenn sie zu lang ist, um an das Steuerelement anzupassen. Die Textzeichenfolge ist möglicherweise leer.
Die spezielle Erstellung der Formatierte Textzeichenfolge in diesem Feld ist erforderlich, wenn der Text von einem Textsteuerelement angezeigt werden soll, sich in einem Dialogfeld mit dem TrackDiskpace-Attribut befindet. Dies ist der Fall, der durch die TrackDiskSpace Dialog Style Bit in den Attributen der Dialogtabelleangezeigt wird. Wenn in diesem Fall die formatierte Zeichenfolge in der Textspalte der Steuerelementtabelle 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, erfordert die formatierte Zeichenfolge "[DlgTextFont]MyText[ProductName] " das Leerzeichen am Ende nach der schließenden Klammer. Dieser zusätzliche Speicherplatz ist vom Installationsprogramm erforderlich, um den Text im Textsteuerelement korrekt anzuzeigen.
Sie können eine kurze beschreibende Textzeichenfolge für die VolumeCostList-, ListView-, DirectoryList-und die SelectionTree-Steuerelementeeingeben. Dieser Text wird vom Benutzer nicht angezeigt, kann aber von Bildschirmsprachausgaben als Beschreibung des Steuerelements gelesen werden.
Siehe auch Barrierefreiheit.
-
Control_Next
-
Der Name eines anderen Steuerelements im selben Dialogfeld und ein externer Schlüssel zur zweiten Spalte der Steuerelementtabelle. Wenn sich der Fokus im Dialogfeld auf dem Steuerelement in der Spalte "Steuerelement" befindet, verschiebt das Drücken der TAB-TASTE den Fokus auf das Steuerelement, das in der spalte Control_Next 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 außerhalb des Zyklus verbleiben. In diesem Fall ist dieses Feld möglicherweise leer.
Siehe auch Barrierefreiheit.
-
Hilfe
-
Optionale, lokalisierbare Textzeichenfolgen, die mit der Schaltfläche "Hilfe" verwendet werden. Die Zeichenfolge wird in zwei Teile durch ein Trennzeichen (|) unterteilt. Der erste Teil der Zeichenfolge wird als QuickInfo-Text verwendet. Dieser Text wird von Bildschirmsprachausgaben für Steuerelemente verwendet, die ein Bild enthalten. Der zweite Teil der Zeichenfolge ist für die zukünftige Verwendung reserviert. Das Trennzeichen ist erforderlich, auch wenn nur eine der beiden Textarten vorhanden ist.
Bemerkungen
Die ganzzahligen Werte für x, y, width und height befinden sich in den Installationseinheiten, nicht dialogeinheiten. Eine Installationsprogrammeinheit ist gleich einem zwölften der Höhe des Schriftgrads von 10 Punkt MS Sans Serif. Koordinaten für die Steuerelemente sind relativ zum Billboard.
Validierung