Elemento da interface do usuário Microsoft.Common.OptionsGroup

O controle OptionsGroup permite que os usuários selecionem uma opção entre duas ou mais opções. Um usuário pode selecionar apenas uma opção.

Nota

No passado, esse controle processava as opções horizontalmente. Agora, o controle apresenta as opções verticalmente como botões de opção.

Exemplo de interface do usuário

Esquema

{
  "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
}

Saída de exemplo

"two"

Observações

• O rótulo para constraints.allowedValues é o texto de exibição de um item e seu valor é o valor de saída do elemento quando selecionado.
• Se especificado, o valor padrão deve ser um rótulo presente no constraints.allowedValues. Se não for especificado, o primeiro item será constraints.allowedValues selecionado por padrão. O valor predefinido é null.
• constraints.allowedValues deve ter pelo menos um item.

Próximos passos

• Para obter uma introdução à criação de definições de interface do usuário, consulte Introdução a CreateUiDefinition.
• Para obter uma descrição das propriedades comuns em elementos da interface do usuário, consulte Elementos CreateUiDefinition.