Controle Opção no Power Apps

Um controle de entrada que mostra diversas opções, entre as quais os usuários podem selecionar apenas uma por vez.

Descrição

Um controle Opção, um controle de entrada HTML padrão, é usado melhor com apenas algumas opções mutuamente exclusivas.

O controle pode ter um layout horizontal ou vertical.

Principais propriedades

Default – o valor de um controle antes que o usuário o altere.

Items – a fonte de dados exibida em um controle como uma galeria, uma lista ou um gráfico.

Layout – indica se as opções são dispostas vertical ou horizontalmente.

Value – o valor de um controle de entrada.

Selected – o registro de dados que representa o item selecionado.

Todas as propriedades

Align – a localização do texto em relação ao centro horizontal do respectivo controle.

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

Color – a cor do texto em um controle.

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição), ou está desabilitado (Desabilitado).

DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.

DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

Fill – a cor da tela de fundo de um controle.

FocusedBorderColor – a cor da borda do controle quando ele está focalizado.

FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.

Font – o nome da família de fontes em que o texto é exibido.

FontWeight – o peso do texto em um controle: Negrito , Seminegrito, Normal ou Mais claro.

Height – a distância entre a parte superior do controle e as bordas inferiores.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Italic – se o texto em um controle está em itálico.

LineHeight – a distância entre, por exemplo, linhas de texto ou itens em uma lista.

OnChange – ações a serem executadas quando o usuário alterar o valor de um controle (por exemplo, ajustando um controle deslizante).

OnSelect – Ações a serem executadas quando o usuário tocar ou clicar em um controle.

PaddingBottom – a distância entre o texto em um controle e a borda inferior desse controle.

PaddingLeft – a distância entre o texto em um controle e a borda esquerda desse controle.

PaddingRight – a distância entre o texto em um controle e a borda direita desse controle.

PaddingTop – a distância entre o texto em um controle e a borda superior desse controle.

PressedColor – a cor do texto em um controle quando o usuário toca ou clica nesse controle.

PressedFill – a cor da tela de fundo de um controle quando o usuário toca ou clica nesse controle.

OpçãoBackgroundFill – a cor da tela de fundo dos círculos em um controle de botão de opção.

OpçãoBorderColor – a cor do círculo de cada opção em um controle de botão de opção.

OpçãoSelectionFill – a cor exibida dentro do círculo da opção selecionada em um controle de botão de opção.

OpçãoSize – o diâmetro dos círculos em um controle de botão de opção.

Reset – se um controle é revertido para seu valor padrão.

SelectedText (Deprecated) – um valor de cadeia de caracteres que representa o item selecionado.

Size – o tamanho da fonte do texto que aparece em um controle.

Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.

TabIndex – ordem de navegação do teclado em relação a outros controles.

Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Underline – se uma linha é exibida sob o texto que aparece em um controle.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre as bordas esquerda e direita de um controle.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (ou a tela, se não houver contêiner pai).

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (ou a tela, se não houver contêiner pai).

Distinct( DataSource, ColumnName )

Exemplo

  1. Adicione um controle Opção, chame-o de Pricing e defina sua propriedade Items como esta fórmula:

    ["Standard", "Premium"]

    Não sabe como adicionar, nomear e configurar um controle?

  2. Adicione um controle Rótulo, mova-o para abaixo do controle Opção e defina a propriedade Text do controle Rótulo com esta fórmula:

    If("Premium" in Pricing.Selected.Value, "$200 per day", "$150 per day")

    Deseja saber mais sobre a função If ou sobre outras funções?

  3. Mantendo a tecla Alt pressionada, selecione uma das opções no controle de Opção.

    O controle Rótulo mostra o texto apropriado para sua escolha.

  4. (opcional) Mantendo a tecla Alt pressionada, selecione a outra opção para confirmar se o texto apropriado é exibido.

Diretrizes de acessibilidade

Contraste de cores

Além dos requisitos de contraste de cores padrão, garanta o contraste de cores adequado entre:

  • RadioSelectionFill e RadioBackgroundFill
  • RadioBackgroundFill e Fill

Suporte ao leitor de tela

  • Verifique se cada opção tem um Value.
  • Adicione um Rótulo imediatamente antes do controle Opção para servir como o título.

Suporte de teclado

  • Defina a propriedade TabIndex como zero ou superior para que os usuários de teclado possam navegar para ela.
  • Defina as propriedades FocusedBorderColor e FocusedBorderThickness para que os indicadores de foco estejam claramente visíveis.

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).