Controlo Botão de alternar no Power Apps

  • Artigo

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

Descrição

Os botões de seletor foram concebidos para as GUIs recentes, mas comportam-se da mesma forma que as caixas de verificação.

Propriedades principais

Default – o valor inicial de um controlo antes de ser alterado pelo utilizador.

Value – o valor de um controlo de introdução.

Propriedades adicionais

AccessibleLabel – a etiqueta para os leitores de ecrãs.

BorderColor – a cor do limite de um controlo.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.

BorderThickness – a espessura do limite de um controlo.

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).

DisabledBorderColor – a cor do limite de um controlo se a propriedade DisplayMode do controlo estiver definida como Desativada.

FalseFill – a cor de preenchimento do botão de alternar quando este está desativado.

FalseHoverFill – a cor de preenchimento ao pairar no botão de alternar quando este está desativado.

FalseText – o texto apresentado quando o botão de alternar está desativado.

Fill – a cor de fundo de um controlo.

FocusedBorderColor – a cor do limite de um controlo quando o controlo é destacado.

FocusedBorderThickness – a espessura do limite de um controlo quando o controlo é destacado.

HandleFill – a cor de preenchimento da alça do botão de alternar.

Height – a distância entre as margens superiores e inferiores de um controlo.

HoverBorderColor – a cor do limite de um controlo quando o utilizador mantém o ponteiro do rato nesse controlo.

OnChange – Ações a realizar quando o utilizador altera o valor de um controlo (por exemplo, ao ajustar um controlo de deslize).

OnCheck – Ações a realizar quando o valor de uma caixa de verificação ou alternância é alterado para verdadeiro.

OnSelect– Ações a realizar quando o utilizador toca ou clica num controlo.

OnUncheck – Ações a realizar quando o valor de uma caixa de verificação ou alternância é alterado para falso.

PressedBorderColor – a cor do limite de um controlo quando o utilizador toca ou clica nesse controlo.

RailFill – a cor de fundo do retângulo num botão de alternar quando o seu valor é falso ou a cor da linha à direita do identificador num controlo de deslize.

RailHoverFill – quando passa o rato por cima de um botão de alternar ou um controlo de deslize, a cor de fundo do retângulo num botão de alternar quando o respetivo valor é falso ou a cor da linha à direita da alça num controlo de deslize.

Reset – se um controlo é revertido para o valor predefinido.

ShowLabel – se uma etiqueta de texto é apresentada ao lado do botão de alternar.

TabIndex – a ordem de navegação no teclado em relação a outros controlos.

TextPosition – se a etiqueta está à esquerda ou à direita do botão de alternar.

Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.

TrueFill – cor de preenchimento do botão de alternar quando este está ativado.

TrueHoverFill – cor de preenchimento ao pairar sobre o botão de alternar quando este está ativado.

TrueText – texto apresentado quando o botão de alternar está ativado.

ValueFill – a cor de fundo do retângulo num botão de alternar quando o seu valor é verdadeiro ou a cor da linha à esquerda da alça num controlo de deslize.

ValueHoverFill – quando mantém o ponteiro do rato sobre um botão de alternar ou um controlo de deslize, a cor de fundo do retângulo num botão de alternar quando o respetivo valor é verdadeiro ou a cor da linha à esquerda da alça num controlo de deslize.

Visible – se um controlo é apresentado ou está oculto.

Width – a distância entre as margens esquerda e direita de um controlo.

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( Condition, Result )

Exemplo

  1. Adicione um seletor e dê-lhe nome MemberDiscount.

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

  2. Adicione uma etiqueta e defina a propriedade Text para esta fórmula:
    If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

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

  3. Prima F5 e altere o valor de MemberDiscount.

    A etiqueta mostra um preço diferente, consoante MemberDiscount esteja ativado ou desativado.

  4. Para voltar à área de trabalho predefinida, prima Esc.

Diretrizes de acessibilidade

Contraste de cor

Tem de existir contraste de cor adequado entre:

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

Trata-se de uma adição aos requisitos de contraste de cor padrão.

Suporte a leitor de ecrã

  • AccessibleLabel tem de estar presente.
  • FalseText tem de estar presente.
  • TrueText tem de estar presente.

Suporte para visão reduzida

  • Considere a definição ShowLabel como true para que os utilizadores possam rapidamente determinar o valor do botão alternar.

Suporte de teclado

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).