RadioButton-Tabelle
Optionsfelder werden nicht als einzelne Steuerelemente behandelt, aber sie sind Teil einer Optionsfeldgruppe, die als RadioButtonGroup-Steuerelementfungiert. Die RadioButton-Tabelle listet die Schaltflächen für alle Gruppen auf.
Die RadioButton-Tabelle enthält die folgenden Spalten.
| Spalte | Art | Schlüssel | Nullable |
|---|---|---|---|
| Eigentum | Bezeichner | Y | N |
| Bestellung | ganze Zahl | Y | N |
| Wert | formatierte | N | N |
| X | ganze Zahl | N | N |
| Y | ganze Zahl | N | N |
| Breite | ganze Zahl | N | N |
| Höhe | ganze Zahl | N | N |
| Text | formatierte | N | Y |
| Hilfe | N | Y |
Spalten
-
-Eigenschaft
-
Eine benannte Eigenschaft, die an dieses Optionsfeld gebunden werden soll. Alle Schaltflächen, die mit derselben Eigenschaft verknüpft sind, werden Teil derselben Gruppe.
-
Bestellung
-
Eine positive ganze Zahl, die verwendet wird, um die Reihenfolge der Elemente in einer Liste zu bestimmen. Die ganzzahligen Zahlen müssen nicht aufeinander folgen.
-
wert
-
Die dieser Schaltfläche zugeordnete Wertzeichenfolge. Durch Auswählen der Schaltfläche wird die zugeordnete Eigenschaft auf diesen Wert festgelegt.
-
X
-
Die horizontale Koordinate innerhalb der Gruppe der oberen linken Ecke des umgebenden Rechtecks des Optionsfelds. Dies muss eine nicht negative Zahl sein.
-
Y
-
Die vertikale Koordinate innerhalb der Gruppe der oberen linken Ecke des umgebenden Rechtecks des Optionsfelds. Dies muss eine nicht negative Zahl sein.
-
breite
-
Die Breite der Schaltfläche. Dies muss eine nicht negative Zahl sein.
-
Höhe
-
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, damit er in das Steuerelement passt, wird er abgeschnitten. Wenn die Schaltfläche ein Symbol oder eine Bitmap anzeigt, enthält diese Spalte den Namen des Bilds, bei dem es sich um einen Schlüssel in der Binärtabellehandelt. Es gibt keine Möglichkeit, sowohl ein Bild als auch text auf einer Schaltfläche anzuzeigen.
-
Hilfe
-
Die hilfezeichenfolgen, die mit der Schaltfläche verwendet werden. Der Text ist optional und lokalisierbar. Die Zeichenfolge wird in zwei Teile unterteilt, die durch ein Zeichen (|) getrennt sind. Der erste Teil der Zeichenfolge wird als QuickInfo-Text verwendet. Dieser Text wird von Bildschirmsprachausgaben für Steuerelemente angezeigt, die ein Bild enthalten. Der zweite Teil wird für kontextabhängige Hilfe verwendet, obwohl kontextbezogene Hilfe noch nicht implementiert wurde. 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.
Die Koordinaten der Schaltflächen werden relativ zur Gruppe angegeben. Wenn die Koordinaten der Gruppe geändert werden, bleiben die Schaltflächen innerhalb der Gruppe an derselben relativen Position.
Der Inhalt der Felder "Wert" und "Text" wird von der MsiFormatRecord Funktion formatiert, wenn das Steuerelement erstellt wird. Daher können sie einen beliebigen Ausdruck enthalten, den die MsiFormatRecord-Funktion interpretieren kann. Die Formatierung erfolgt nur, wenn das Steuerelement erstellt wird und nicht aktualisiert wird, wenn eine eigenschaft, die an dem Ausdruck beteiligt ist, während der Lebensdauer des Steuerelements geändert wird.
Jedes RadioButtonGroup-Steuerelement ist einer Eigenschaft zugeordnet. Der Standardwert für diese Eigenschaft muss in der Property-Tabelleinitialisiert werden. Innerhalb jeder in der RadioButton-Tabelle angegebenen RadioButtonGroup kann ein Optionsfeld mit einem Wert im Feld "Wert" vorhanden sein, der dem Standardwert für diese Eigenschaft entspricht. Dies ist die Standardschaltfläche für das RadioButtonGroup-Steuerelement. Die Standardschaltfläche wird zunächst als im Steuerelement ausgewählt angezeigt.
Beachten Sie, dass der Benutzer den Fokus in einem Dialogfeld nicht ändern kann, indem er die TAB-TASTE auf ein RadioButtonGroup-Steuerelement drückt, bis eine der Schaltflächen in der Gruppe ausgewählt wurde. Um den Fokus auf diese Schaltflächengruppe zu setzen, indem Sie die TAB-TASTE drücken, geben Sie eine der Schaltflächen als Standardschaltfläche für die Gruppe an.
Validierung