Controlo Botão no Power Apps

Um controlo em que o utilizador pode clicar ou tocar para interagir com a aplicação.

Descrição

Configure a propriedade OnSelect de um controlo de Botão para executar uma ou mais fórmulas quando o utilizador clica ou toca no controlo.

Propriedades principais

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

Text – texto que é apresentado num controlo ou que o utilizador escreve num controlo.

Propriedades adicionais

Align – a localização de texto em relação ao centro horizontal do seu controlo.

AutoDisableOnSelect – desativa automaticamente o controlo enquanto o comportamento de OnSelect está em execução.

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.

Color – a cor do texto num 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.

DisabledColor – a cor do texto num controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.

DisabledFill – a cor de fundo de um controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.

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

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

Fill – a cor de fundo de um controlo.

Font – o nome da família dos tipos de letra que aparecem no texto.

FontWeight – a espessura do texto num controlo: Negrito, Seminegrito, Normal ou Mais leve.

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.

HoverColor – a cor do texto num controlo quando o utilizador mantém o ponteiro do rato no mesmo.

HoverFill – a cor de fundo de um controlo quando o utilizador mantém o ponteiro do rato no mesmo.

Italic – se o texto num controlo estiver em itálico.

PaddingBottom – a distância entre o texto num controlo e o limite inferior desse controlo.

PaddingLeft – a distância entre o texto num controlo e o limite esquerdo desse controlo.

PaddingRight – a distância entre o texto num controlo e o limite direito desse controlo.

PaddingTop – a distância entre o texto num controlo e o limite superior desse controlo.

Pressed – verdadeiro enquanto um controlo é premido; caso contrário, falso.

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

PressedColor – a cor do texto num controlo quando o utilizador toca ou clica nesse controlo.

PressedFill – a cor de fundo de um controlo quando o utilizador toca ou clica nesse controlo.

RadiusBottomLeft – o grau a que o canto inferior esquerdo de um controlo é arredondado.

RadiusBottomRight – o grau a que o canto inferior direito de um controlo é arredondado.

RadiusTopLeft – o grau a que o canto superior esquerdo de um controlo é arredondado.

RadiusTopRight – o grau a que o canto superior direito de um controlo é arredondado.

Size – o tamanho do tipo de letra do texto que é apresentado num controlo.

Strikethrough – se é apresentada uma linha no meio do texto que aparece num controlo.

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

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

Underline – se é apresentada uma linha sob o texto que aparece num controlo.

VerticalAlign – a localização de texto num controlo em relação ao centro vertical desse controlo.

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

Navigate( ScreenName, ScreenTransitionValue )

Exemplos

Adicionar uma fórmula básica a um botão

1. Adicione um controlo de Introdução de texto e designe-o Origem.

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

2. Adicione um controlo de Botão, defina a respetiva propriedade Text como "Adicionar", e defina a respetiva propriedade OnSelect como esta fórmula:
   UpdateContext({Total:Total + Value(Source.Text)})

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

3. Adicione um controlo de Etiqueta, defina a sua propriedade Text na barra de fórmula para Valor(Total) e, em seguida, prima F5.

4. Apague o texto predefinido de Origem, escreva um número e, em seguida, clique ou toque em Adicionar.

   O controlo Etiqueta mostra o número que introduziu.

5. Apague o número de Origem, escreva outro número e, em seguida, clique ou toque em Adicionar.

   O controlo de Etiqueta mostra a soma dos dois números que introduziu.

6. (opcional) Repita o passo anterior uma ou mais vezes.

7. Para voltar para a área de trabalho predefinida, prima Esc (ou clique ou toque no ícone de fecho no canto superior direito).

Configurar um botão com várias fórmulas

Adicione uma fórmula que limpe o controlo de Introdução de texto entre as entradas.

1. Defina a propriedade HintText de Origem como "Introduzir um número".

2. Defina a propriedade OnSelect de Adicionar como esta fórmula:

   UpdateContext({Total:Total + Value(Source.Text)});
   UpdateContext({ClearInput: ""})

   Nota

   Separe várias fórmulas com ponto e vírgula ";".

3. Defina a propriedade Default de Origem como ClearInput.

4. Prima F5 e, em seguida, teste a aplicação, adicionando vários números em conjunto.

Adicionar outro botão para repor o total

Adicione um segundo botão para limpar o total entre os cálculos.

1. Adicione outro controlo de Botão, defina a respetiva propriedade Text como "Limpar" e defina a respetiva propriedade OnSelect como esta fórmula:

   UpdateContext({Total:0})

2. Prima F5, adicione vários números em conjunto e, em seguida, clique ou toque em Limpar para repor o total.

Alterar o aspeto de um botão

Alterar a forma de um botão

Por predefinição, o Power Apps cria um controlo de Botão retangular com os cantos arredondados. Pode fazer modificações básicas à forma de um controlo de Botão, definindo as respetivas propriedades Height, Width e Radius.

Nota

Os Ícones e Formas fornecem uma grande variedade de designs e podem executar algumas das mesmas funções básicas que os controlos de Botão executam. No entanto, os Icons e Shapes não têm uma propriedade Text.

1. Adicione um controlo de Botão e defina as respetivas propriedades Height e Width como 300 para criar um botão quadrado grande.

2. Modifique as propriedades RadiusTopLeft, RadiusTopRight, RadiusBottomLeft e RadiusBottomRight para ajustar a quantidade de curvatura em cada canto. Seguem-se alguns exemplos de formas diferentes, cada uma delas começando com um botão quadrado com 300 x 300:

   • Defina os quatro valores de Radius como 150 para criar um círculo.
   • Defina os valores para RadiusTopLeft e RadiusBottomRight como 300 para criar um Botão em forma de folha.
   • Defina os valores para RadiusTopLeft e RadiusTopRight como 300, e os valores para RadiusBottomLeft e RadiusBottomRight como 100 para criar um botão em forma de separador.

Alterar a cor de um botão quando passa com o rato sobre o mesmo

Por predefinição, a cor de preenchimento de um controlo de Botão esbate-se 20% quando passa com o rato sobre o mesmo. Pode ajustar este comportamento, alterando a propriedade HoverFill, que utiliza a função ColorFade. Se definir a fórmula ColorFade como uma percentagem positiva, a cor torna-se mais clara quando passa com o rato sobre o botão, enquanto que uma percentagem negativa torna a cor mais escura.

• Altere a percentagem de ColorFade na propriedade HoverFill de um dos botões que criou e observe os efeitos.

Também pode especificar a cor de um controlo de Botão, definindo a respetiva propriedade HoverFill como uma fórmula que contém a função ColorValue em vez da função ColorFade, tal como em ColorValue("Vermelho").

Nota

O valor de cor pode ser qualquer definição de cor CSS, ou um nome ou um valor hexadecimal.

• Substitua a função ColorFade por uma função ColorValue num dos botões que criou e observe os efeitos.

Diretrizes de acessibilidade

Contraste de cor

• Aplicam-se os requisitos de contraste de cor padrão.

Suporte a leitor de ecrã

• Text tem de estar presente.

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).