RadioButton-Tabelle
Optionsfelder werden nicht als einzelne Steuerelemente behandelt, sondern sind Teil einer Optionsfeldgruppe, die als RadioButtonGroup-Steuerelement fungiert. In der RadioButton-Tabelle sind die Schaltflächen für alle Gruppen aufgelistet.
Die RadioButton-Tabelle hat die folgenden Spalten.
| Spalte | Typ | Schlüssel | Nullwerte zulässig |
|---|---|---|---|
| Eigenschaft | Identifier | J | N |
| Order | Integer | J | N |
| Wert | Formatted | N | N |
| X | Integer | N | N |
| J | Integer | N | N |
| Breite | Integer | N | N |
| Höhe | Integer | N | N |
| Text | Formatted | N | J |
| Hilfe | Text | N | J |
Spalten
-
Property
-
Eine benannte Eigenschaft, die an dieses Optionsfeld gebunden werden soll. Alle Schaltflächen, die an dieselbe Eigenschaft gebunden sind, werden Teil derselben Gruppe.
-
Order
-
Eine positive ganze Zahl zum Bestimmen der Reihenfolge der Elemente innerhalb einer Liste. Die ganzen Zahlen müssen nicht aufeinander folgen.
-
Value
-
Die dieser Schaltfläche zugeordnete Wertzeichenfolge. Wenn Sie die Schaltfläche auswählen, wird die zugeordnete Eigenschaft auf diesen Wert festgelegt.
-
X
-
Die horizontale Koordinate innerhalb der Gruppe links oben im umgebenden Rechteck des Optionsfelds. Dies muss eine nicht negative Zahl sein.
-
Y
-
Die vertikale Koordinate in der Gruppe der links oben im umgebenden Rechteck des Optionsfelds. Dies muss eine nicht negative Zahl sein.
-
Width
-
Die Breite der Schaltfläche. Dies muss eine nicht negative Zahl sein.
-
Height
-
Die Höhe der Schaltfläche. Dies muss eine nicht negative Zahl sein.
-
Text
-
Der lokalisierbare, sichtbare Titel, der dem Optionsfeld zugewiesen werden soll. Wenn der Text zu lang ist, um in das Steuerelement zu passen, wird er abgeschnitten. Wenn die Schaltfläche ein Symbol oder ein Bitmap anzeigt, enthält diese Spalte den Namen des Bilds, der ein Schlüssel für die Binary-Tabelle ist. Es ist nicht möglich, auf einer Schaltfläche sowohl ein Bild als auch Text anzuzeigen.
-
Hilfe
-
Die mit der Schaltfläche verwendeten Hilfezeichenfolgen. Der Text ist optional und lokalisierbar. Die Zeichenfolge ist in zwei Teile unterteilt, die durch ein Zeichen (|) getrennt sind. Der erste Teil der Zeichenfolge wird als QuickInfo-Text verwendet. Dieser Text wird von Sprachausgaben für Steuerelemente mit einem Bild gezeigt. Der zweite Teil wird für kontextbezogene Hilfe verwendet, obwohl noch keine kontextbezogene Hilfe implementiert wurde. 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.
Die Koordinaten der Schaltflächen werden relativ zur Gruppe angegeben. Wenn die Koordinaten der Gruppe geändert werden, verbleiben die Schaltflächen innerhalb der Gruppe an der gleichen relativen Position zueinander.
Der Inhalt der Felder „Value“ und „Text“ wird von der MsiFormatRecord-Funktion formatiert, wenn das Steuerelement erstellt wird. Sie können daher einen beliebigen Ausdruck enthalten, den die MsiFormatRecord-Funktion interpretieren kann. Die Formatierung erfolgt nur, wenn das Steuerelement erstellt wird, und wird nicht aktualisiert, wenn eine Eigenschaft, die am Ausdruck beteiligt ist, während der Lebensdauer des Steuerelements geändert wird.
Jedes RadioButtonGroup-Steuerelement ist einer Eigenschaft zugeordnet. Der Standardwert dieser Eigenschaft muss in der Property-Tabelle initialisiert werden. In jeder RadioButtonGroup, die in der RadioButton-Tabelle angegeben ist, kann ein Optionsfeld mit einem Wert im Feld „Value“ vorhanden sein, der mit dem Standardwert dieser Eigenschaft übereinstimmt. Dies ist die Standardoptionsfeld des RadioButtonGroup-Steuerelements. Das Standardoptionsfeld wird zunächst als im Steuerelement ausgewählt angezeigt.
Beachten Sie, dass der Benutzer den Fokus in einem Dialogfeld nicht durch Drücken der TAB-TASTE in ein RadioButtonGroup-Steuerelement ändern kann, bis eine der Schaltflächen in der Gruppe ausgewählt wurde. Um den Fokus auf diese Optionsfeldgruppe durch Drücken der TAB-TASTE zu verschieben, geben Sie eines der Optionsfelder als Standardoptionsfeld für die Gruppe an.
Überprüfen