Compartilhar via


Controle de alternância no Power Apps

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

Description

Uma alternância foi projetada para GUIs recentes, mas se comporta da mesma maneira que uma caixa de seleção.

Principais propriedades

Padrão – o valor inicial de um controle antes de ser alterado pelo usuário.

Valor – o valor de um controle de entrada.

Propriedades adicionais

AccessibleLabel – Rótulo para leitores de tela.

BorderColor – A cor da borda de um controle.

BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.

BorderThickness – A espessura da borda de um controle.

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

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

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

FalseHoverFill – a cor de preenchimento do mouse de 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 de um controle quando o controle está focado.

FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.

HandleFill – A cor de preenchimento do identificador de alternância.

Altura – a distância entre as bordas superior e inferior de um controle.

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

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

OnCheck – Ações a serem executadas quando o valor de uma caixa de seleção ou uma alternância mudar para true.

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

OnUncheck – Ações a serem executadas quando o valor de uma caixa de seleção ou uma alternância for alterado para false.

PressedBorderColor – A cor da borda de um controle quando o usuário toca ou clica nesse controle.

RailFill – A cor da tela de fundo do retângulo em um controle de alternância quando seu valor é false ou a cor da linha à direita do identificador em um controle deslizante.

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

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

ShowLabel – Se um rótulo de texto é mostrado ao lado do controle de alternância.

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

TextPosition – se o rótulo está à esquerda ou à direita do controle de alternância.

Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

TrueFill – Alternar a cor de preenchimento quando a alternância estiver ativada.

TrueHoverFill – Alternar a cor de preenchimento do mouse quando a alternância estiver ativada.

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

ValueFill – A cor da tela de fundo do retângulo em um controle de alternância quando seu valor é verdadeiro ou a cor da linha à esquerda do identificador em um controle deslizante.

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

Visível – se um controle aparece ou está oculto.

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

If( Condição, Resultado )

Example

  1. Adicione uma alternância e nomeie-a como MemberDiscount.

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

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

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

  3. Pressione F5 e altere o valor de MemberDiscount.

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

  4. Para retornar ao workspace padrão, pressione Esc.

Diretrizes de acessibilidade

Contraste de cores

Deve haver contraste de cores adequado entre:

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

Isso é além dos requisitos de contraste de cores padrão.

Suporte ao leitor de tela

  • AccessibleLabel deve estar presente.
  • FalseText deve estar presente.
  • TrueText deve estar presente.

Suporte à visão baixa

  • Considere definir ShowLabelcomo true para que os usuários possam determinar rapidamente o valor de alternância.

Suporte ao teclado