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.

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

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:

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

Suporte a leitor de ecrã

  • Text tem de estar presente.

Suporte de teclado

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