Controle Alternância no Power Apps

Um controle que o usuário pode ativar ou desativar movendo seu identificador.

Descrição

Um controle Toggle é designado para as GUIs recentes, mas se comporta da mesma forma como uma caixa de seleção.

Principais propriedades

Default – o valor inicial de um controle antes de ele ser alterado pelo usuário.

Value – o valor de um controle de entrada.

Propriedades adicionais

AccessibleLabel – rótulo para leitores de tela.

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.

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.

FalseFill – a cor de preenchimento da alternância quando a alternância está desativada.

FalseHoverFill – a cor de preenchimento ao focalizar da alternância quando a alternância está desativada.

FalseText – o texto mostrado quando a alternância está desativada.

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.

HandleFill – A cor do preenchimento da alça de alternância.

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

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.

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

OnCheck – Ações a serem realizadas quando o valor de uma caixa de seleção ou um controle de alternância muda para true.

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

OnUncheck – Ações a serem realizadas quando o valor de uma caixa de seleção ou um controle de alternância muda para false.

PressedBorderColor – a cor da borda do controle quando o usuário toca ou clica nesse controle.

RailFill – a cor da tela de fundo do retângulo em um controle Alternância quando seu valor é falso ou a cor da linha à direita do botão em um controle Controle deslizante.

RailHoverFill – quando você passa o mouse sobre um controle Alternância ou um controle Controle deslizante, a cor de fundo do retângulo em um controle Alternância quando seu valor é falso ou a cor da linha à direita do identificador em um controle Controle deslizante.

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

ShowRótulo – especifica se um rótulo de texto é exibido ao lado do controle Alternância.

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

TextPosition – especifica se o rótulo fica à esquerda ou à direita do controle Alternância.

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

TrueFill – a cor de preenchimento da alternância quando a alternância está ativada.

TrueHoverFill – a cor de preenchimento ao focalizar da alternância quando a alternância está ativada.

TrueText – o texto mostrado quando a alternância está ativada.

ValueFill – a cor da tela de fundo do retângulo em um controle Alternância quando seu valor é verdadeiro ou a cor da linha à esquerda do botão em um controle Controle deslizante.

ValueHoverFill – quando você mantém o ponteiro do mouse sobre um controle Alternância ou sobre um controle Controle deslizante, a cor da tela de fundo do retângulo em um controle Alternância quando seu valor é verdadeiro ou a cor da linha à esquerda do botão em um controle Controle deslizante.

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).

Funções relacionadas

If( Condition, Result )

Exemplo

1. Adicione um controle Toggle e nomeie-o como MemberDiscount.

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

2. Adicione um rótulo e defina sua propriedade Text como esta fórmula:
   If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

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

3. Pressione F5 e altere o valor de MemberDiscount.

   O rótulo mostra um preço diferente, dependendo se MemberDiscount está ativado ou desativado.

4. Para retornar ao espaço de trabalho padrão, pressione Esc.

Diretrizes de acessibilidade

Contraste de cores

É necessário haver um contraste de cores adequado entre:

• HandleFill e FalseFill
• HandleFill e FalseHoverFill
• HandleFill e TrueFill
• HandleFill e TrueHoverFill
• FalseFill e a cor fora do controle
• FalseHoverFill e a cor fora do controle
• TrueFill e a cor fora do controle
• TrueHoverFill e a cor fora do controle

Isso é adicional aos requisitos de contraste de cores padrão.

Suporte ao leitor de tela

• AccessibleLabel precisa estar presente.
• FalseText precisa estar presente.
• TrueText precisa estar presente.

Suporte à deficiência visual

• Defina ShowLabel como verdadeiro para que os usuários possam determinar rapidamente o valor de alternância.

Suporte de teclado

• TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar para ela.
• Os indicadores de foco precisam ser evidentes. Use FocusedBorderColor e FocusedBorderThickness para fazer isso.