Steuertabelle

Die Tabelle Steuerelement 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
Dialogfeld_ 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
Attributes DoubleInteger N J
Eigenschaft Identifier N J
Text Formatiert N J
Steuern _ als Nächstes Identifier N J
Hilfe Text N J

Spalten

Dialogfeld_

Externer Schlüssel für die erste Spalte der Dialogtabelle, der Name des Dialogfelds.

Steuerung

Name des Steuerelements. Dieser Name muss innerhalb eines Dialogfelds eindeutig sein, kann aber in verschiedenen Dialogfeldern wiederholt werden. Die Spalte Control in Kombination mit der Spalte Dialog _ bildet den Primärschlüssel für diese Tabelle.

Typ

Der Typ des Steuerelements. Eine Liste der Steuerelementtypen finden Sie unter Controls.

X

Horizontale Koordinate der linken oberen Ecke der rechteckigen Begrenzung des Steuerelements. Dies muss eine nicht negative Zahl sein. Weitere Informationen finden Sie unter Positionssteuerelementattribut.

Y

Vertikale Koordinate der linken oberen Ecke der rechteckigen Begrenzung des Steuerelements. Dies muss eine nicht negative Zahl sein. Weitere Informationen finden Sie unter Positionssteuerelementattribut.

Breite

Breite der rechteckigen Begrenzung des Steuerelements. Dies muss eine nicht negative Zahl sein. Weitere Informationen finden Sie unter Positionssteuerelementattribut.

Höhe

Höhe der rechteckigen Begrenzung des Steuerelements. Dies muss eine nicht negative Zahl sein. Weitere Informationen finden Sie unter Positionssteuerelementattribut.

Attribute

Ein 32-Bit-Wort, das die Bitflags 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 den 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 werden durch Verknüpfen mit derselben Eigenschaft an eine Gruppe gebunden. Diese Spalte ist für aktive Steuerelemente erforderlich.

Text

Eine lokalisierbare Zeichenfolge, die verwendet wird, um den ursprünglichen Text festzulegen, der in einem -Steuerelement enthalten ist. Die Zeichenfolge kann auch eingebettete Eigenschaften enthalten. Die Syntax einer formatierten Zeichenfolge mit Eigenschaften finden Sie in der MsiFormatRecord-Funktion. Geben Sie Größe, Schriftart und Farbe des Texts an, indem Sie der Textzeichenfolge { style} voran \ stellen, wobei style ein Textformat ist, das in der TextStyle-Spalte der TextStyle-Tabelleerstellt wurde. Die Textzeichenfolge wird abgeschnitten, wenn sie zu lang ist, um an das Steuerelement zu passen. Die Textzeichenfolge ist möglicherweise leer.

Eine spezielle Erstellung der formatierten Textzeichenfolge in diesem Feld ist erforderlich, wenn der Text von einem Textsteuerelement in einem Dialogfeld mit dem TrackDiskpace-Attribut angezeigt werden soll. Dies ist der Fall, der vom TrackDiskSpace Dialog Style Bit angegeben wird, das in den Attributen der Dialogtabelleangezeigt wird. Wenn in diesem Fall die formatierte 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, benötigt die formatierte Zeichenfolge [ "DlgTextFont ] MyText [ ] ProductName" das Leerzeichen am Ende nach der schließenden Klammer. Dieser zusätzliche Platz ist für das Installationsprogramm erforderlich, um den Text im Text-Steuerelement ordnungsgemäß anzuzeigen.

Sie können eine kurze beschreibende Textzeichenfolge für die Steuerelemente VolumeCostList, ListView, DirectoryListund SelectionTreeeingeben. Dieser Text wird dem Benutzer nicht angezeigt, kann aber von Sprachausgaben als Beschreibung des Steuerelements gelesen werden.

Siehe auch Barrierefreiheit.

Steuern _ als Nächstes

Der Name eines anderen Steuerelements im gleichen 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 Spalte Steuerelement befindet, wird durch Drücken der TAB-TASTE der Fokus auf das Steuerelement verschoben, das in der Spalte Nächstes Steuerelement aufgeführt _ ist. Aus diesem Grund wird diese Spalte verwendet, um die Registerkartenreihenfolge der Steuerelemente im Dialogfeld anzugeben. Die Links zwischen den Steuerelementen müssen einen geschlossenen Zyklus bilden. Einige Steuerelemente, z. B. statische Textsteuerelemente, können aus dem Zyklus weggelassen werden. In diesem Fall kann dieses Feld leer gelassen werden.

Siehe auch Barrierefreiheit.

Hilfe

Optionale, lokalisierbare Textzeichenfolgen, die mit der Schaltfläche Hilfe verwendet werden. Die Zeichenfolge wird durch ein Trennzeichen ( ) in zwei Teile | unterteilt. Der erste Teil der Zeichenfolge wird als QuickInfo-Text verwendet. Dieser Text wird von Sprachausgaben für Steuerelemente verwendet, die ein Bild enthalten. 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, Breite und Höhe befinden sich in den Installationseinheiten,nicht in Dialogeinheiten. Eine Installationseinheit entspricht einem Zwölftel der Höhe des 10-Punkt-MS Sans Serif-Schriftgrads. Koordinaten für die Steuerelemente sind relativ zum -Steuerelement.

Validierung

ICE03
ICE06
ICE17
ICE20
ICE23
ICE31
ICE32
ICE34
ICE45
ICE46
ICE95