Partilhar via


Alternar o controlo nas Power Apps

Um controlo que o utilizador pode ativar ou desativar ao mover a respetiva alça.

Description

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

Propriedades principais

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 – Etiqueta para leitores de tela.

BorderColor – A cor da borda de um controle.

BorderStyle – Se a borda de um controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – A espessura da borda de um controle.

DisplayMode – Se o controle permite a entrada do usuário (Editar), exibe apenas dados (View) ou está desativado (Disabled).

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

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

FalseHoverFill – A cor de preenchimento do foco de alternância quando a alternância está desativada.

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

Preenchimento – A cor de fundo de um controlo.

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 da alça 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 de uma alternância muda 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 de uma alternância muda para false.

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

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

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

Redefinir – Se um controle reverte 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 que aparece quando o usuário passa o mouse sobre um controle.

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

TrueHoverFill – Alterne a cor de preenchimento do foco quando o botão estiver ativado.

TrueText – Texto mostrado quando o botão de alternância está ativado.

ValueFill – A cor de plano de fundo do retângulo em um controle de alternância quando seu valor é true ou a cor da linha à esquerda da alça em um controle deslizante.

ValueHoverFill – Quando você mantém o ponteiro do mouse em um controle de alternância ou um controle deslizante, a cor de plano de fundo do retângulo em um controle de alternância quando seu valor é true ou a cor da linha à esquerda da alça 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 o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã, se não existir um recipiente principal).

Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã, se não existir um recipiente principal).

If( Condição, Resultado )

Example

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

    Não sabe como adicionar, atribuir um nome e configurar um controlo?

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

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

  3. Pressione F5 e altere o valor de MemberDiscount.

    A etiqueta mostra um preço diferente, dependendo se o MemberDiscount está ativado ou desativado.

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

Diretrizes de acessibilidade

Contraste de cor

Deve haver um contraste de cor 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 cor padrão.

Suporte a leitor de ecrã

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

Suporte para baixa visão

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

Suporte de teclado