Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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).
Funções relacionadas
Example
Adicione uma alternância e nomeie-a como MemberDiscount.
Não sabe como adicionar, atribuir um nome e configurar um controlo?
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?
Pressione F5 e altere o valor de MemberDiscount.
A etiqueta mostra um preço diferente, dependendo se o MemberDiscount está ativado ou desativado.
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
- TabIndex deve ser zero ou maior para que os usuários do teclado possam navegar até ele.
- Os indicadores de focalização devem ser claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.