Controlo Botão de alternar no Power Apps
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).
Funções relacionadas
Exemplo
Adicione um seletor e dê-lhe nome MemberDiscount.
Não sabe como adicionar, atribuir um nome e configurar um controlo?
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?
Prima F5 e altere o valor de MemberDiscount.
A etiqueta mostra um preço diferente, consoante MemberDiscount esteja ativado ou desativado.
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
- TabIndex tem de ser zero ou superior para que os utilizadores do teclado possam navegar nele.
- Os indicadores de foco têm de estar claramente visíveis. Utilize FocusedBorderColor e FocusedBorderThickness para o conseguir.
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).