Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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).
Funções relacionadas
Example
Adicione uma alternância e nomeie-a como MemberDiscount.
Não sabe como adicionar, nomear e configurar um controle?
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?
Pressione F5 e altere o valor de MemberDiscount.
O rótulo mostra um preço diferente, dependendo se o MemberDiscount está ativado ou desativado.
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
- TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar até ele.
- Indicadores de foco devem estar claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.