Benutzeroberflächenelement „Microsoft.Common.OptionsGroup“

Mit dem OptionsGroup-Steuerelement können Benutzer eine Option aus mindestens zwei Optionen auswählen. Ein Benutzer kann nur eine Option auswählen.

Hinweis

In der Vergangenheit hat dieses Steuerelement die Optionen horizontal gerendert. Nun stellt das Steuerelement die Optionen vertikal als Optionsfelder dar.

Benutzeroberflächenbeispiel

Schema

{
  "name": "element1",
  "type": "Microsoft.Common.OptionsGroup",
  "label": "Some options group",
  "defaultValue": "Value two",
  "toolTip": "",
  "constraints": {
    "allowedValues": [
      {
        "label": "Value one",
        "value": "one"
      },
      {
        "label": "Value two",
        "value": "two"
      }
    ],
    "required": true
  },
  "visible": true
}

Beispielausgabe

"two"

Bemerkungen

• Die Bezeichnung für constraints.allowedValues ist der Anzeigetext für ein Element, und sein Wert ist der Ausgabewert des Elements bei der Auswahl.
• Falls angegeben, muss der Standardwert einer in constraints.allowedValues vorhandenen Bezeichnung entsprechen. Wird kein Wert angegeben, wird standardmäßig das erste Element in constraints.allowedValues ausgewählt. Der Standardwert ist null.
• constraints.allowedValues muss mindestens ein Element aufweisen.

Nächste Schritte

• Eine Einführung zum Erstellen von Benutzeroberflächendefinitionen finden Sie unter Erste Schritte mit „CreateUiDefinition“.
• Eine Beschreibung der allgemeinen Eigenschaften in Benutzeroberflächenelementen finden Sie unter CreateUiDefinition-Elemente.