Controle Caixa de seleção no Power Apps

Um controle que o usuário pode selecionar ou desmarcar para definir seu valor como verdadeiro ou falso.

Descrição

O usuário pode especificar um valor booliano usando esse controle familiar, que foi usado em GUIs por décadas.

Principais propriedades

Default – o valor inicial de um controle antes de ele ser alterado pelo usuário.

Text – texto que aparece em um controle ou que o usuário digita em um controle.

Value – o valor de um controle de entrada.

Propriedades adicionais

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

CheckboxBackgroundFill – a cor da tela de fundo da caixa que envolve a marca de seleção em um controle de caixa de seleção.

CheckboxBorderColor – a cor da borda que envolve a marca de seleção em um controle de caixa de seleção.

CheckboxSize – a largura e a altura da caixa que envolve a marca de seleção em um controle de caixa de seleção.

CheckmarkFill – a cor da marca de seleção em um controle de caixa de seleção.

Color – a cor do texto em um controle.

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição), ou está desabilitado (Desabilitado).

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

DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

Fill – a cor da tela de fundo de um controle.

FocusedBorderColor – a cor da borda do controle quando ele está focalizado.

FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.

Font – o nome da família de fontes em que o texto é exibido.

FontWeight – o peso do texto em um controle: Negrito , Seminegrito, Normal ou Mais claro.

Height – a distância entre a parte superior do controle e as bordas inferiores.

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Italic – se o texto em um controle está em itálico.

OnCheck – Ações a serem realizadas quando o valor de uma caixa de seleção ou um controle de alternância muda para true.

OnSelect – Ações a serem executadas quando o usuário tocar ou clicar em um controle.

OnUncheck – Ações a serem realizadas quando o valor de uma caixa de seleção ou um controle de alternância muda para false.

PaddingBottom – a distância entre o texto em um controle e a borda inferior desse controle.

PaddingLeft – a distância entre o texto em um controle e a borda esquerda desse controle.

PaddingRight – a distância entre o texto em um controle e a borda direita desse controle.

PaddingTop – a distância entre o texto em um controle e a borda superior desse controle.

PressedBorderColor – a cor da borda do controle quando o usuário toca ou clica nesse controle.

PressedColor – a cor do texto em um controle quando o usuário toca ou clica nesse controle.

PressedFill – a cor da tela de fundo de um controle quando o usuário toca ou clica nesse controle.

Reset – se um controle é revertido para seu valor padrão.

Size – o tamanho da fonte do texto que aparece em um controle.

Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.

TabIndex – ordem de navegação do teclado em relação a outros controles.

Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Underline – se uma linha é exibida sob o texto que aparece em um controle.

VerticalAlign – a localização do texto em um controle em relação ao centro vertical desse controle.

Visible – se um controle é exibido ou está oculto.

Width – 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

If( Condition, Result )

Exemplo

1. Adicione um controle Caixa de seleção, nomeie-o como chkReserve e defina sua propriedade Text para mostrar Reservar agora.

   Não sabe como adicionar, nomear e configurar um controle?

2. Adicione um controle Seletor de data e defina sua propriedade Visible como esta fórmula:
   If(chkReserve.Value = true, true)

   Deseja saber mais sobre a função If ou sobre outras funções?

3. Pressione F5, clique ou toque em chkReserve para definir sua propriedade Value como verdadeiro, e então clique ou toque em chkReserve novamente para definir sua propriedade Value como falso.

   O controle Seletor de data será exibido quando a propriedade Value de chkReserve for verdadeiro, mas não quando ela for falso.

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

Diretrizes de acessibilidade

Contraste de cores

É necessário haver um contraste de cores adequado entre:

• CheckmarkFill e CheckboxBackgroundFill
• CheckboxBackgroundFill e Fill
• CheckboxBackgroundFill e PressedFill
• CheckboxBackgroundFill e HoverFill

Isso é adicional aos requisitos de contraste de cores padrão.

Suporte ao leitor de tela

• Text precisa estar presente.

Suporte de teclado

• TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar para ela.
• Os indicadores de foco precisam ser evidentes. Use FocusedBorderColor e FocusedBorderThickness para fazer isso.