Função Notify no Power Apps

Apresenta uma mensagem em faixa ao utilizador.

Descrição

A função Notify apresenta uma mensagem em faixa ao utilizador na parte superior do ecrã, sobrepondo-se ao que é atualmente apresentado. A notificação permanecerá até que o utilizador a descarte, outra notificação a substitua ou o tempo limite expire por predefinição de 10 segundos.

São utilizados uma cor e um ícone adequados, dependendo do tipo de mensagem. O tipo é especificado pelo segundo argumento da função:

Argumento NotificationType Descrição
NotificationType.Error Apresenta uma mensagem de erro.
NotificationType.Information (Predefinição) Apresenta a mensagem como informativa.
NotificationType.Success Apresenta a mensagem como êxito.
NotificationType.Warning Apresenta uma mensagem de aviso.

São apresentadas mensagens no ambiente de criação da aplicação e quando os utilizadores finais estão a utilizar a sua aplicação.

A função Notify só pode ser utilizada em fórmulas de comportamento.

A função Notify pode ser utilizada em conjunto com a função IfError para detetar e comunicar erros através de uma mensagem de erro personalizada.

O Power Apps também pode enviar notificações push através de um mecanismo completamente diferente do da função Notify. Para mais informações, consulte Enviar uma notificação no Power Apps.

A função Notify devolve sempre resultados true.

Nota: esta função tinha anteriormente a designação ShowError, uma vez que só podia apresentar mensagens de erro.

Sintaxe

Notify( Mensagem [, NotificationType [ , Timeout ] ] )

  • Mensagem – Obrigatório. A mensagem a apresentar ao utilizador.
  • NotificationType – Opcional. Tipo de mensagem a apresentar de acordo com a tabela acima. A predefinição é NotificationType.Information.
  • Timeout – Opcional. Número de milissegundos a aguardar antes de dispensar automaticamente a notificação. O valor predefinido é 10 segundos (ou 10.000 milisegundos). A notificação será apresentada indefinidamente com um Tempo limite de 0.

Exemplos

Passo a passo

  1. Adicione um controlo Botão ao seu ecrã.

  2. Defina a propriedade OnSelect do Botão como a fórmula:

    Notify( "Hello, World" )
    
  3. Clique em ou prima o botão.

    Sempre que se clicar no botão, será apresentada a mensagem informativa Hello, World ao utilizador. A mesma será descartada automaticamente em 10 segundos (tempo limite predefinido) se o utilizador não o fechar ou premir novamente o botão.

    Ambiente de criação a mostrar a propriedade Button.OnSelect a chamar Notify e a apresentar a mensagem resultante "Hello, World" ao utilizador numa faixa azul

  4. Altere o tipo de mensagem para indicar um erro. Adicione um segundo argumento à fórmula:

    Notify( "Hello, World", NotificationType.Error )
    
  5. Clique em ou prima o botão.

    Agora, sempre que se clicar no botão, será apresentada a mensagem de erro Hello, World ao utilizador. A mesma será descartada automaticamente em 10 segundos (tempo limite predefinido) se o utilizador não o fechar ou premir novamente o botão.

    Ambiente de criação a mostrar a propriedade Button.OnSelect a chamar Notify e a apresentar a mensagem resultante "Hello, World" ao utilizador numa faixa vermelha

  6. Altere o tipo de mensagem para indicar um aviso. Altere o segundo argumento da fórmula:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. Clique em ou prima o botão.

    Agora, sempre que se clicar no botão, será apresentada a mensagem de aviso Hello, World ao utilizador. A mesma será descartada automaticamente em 4 segundos (4000 milisegundos) se o utilizador não o fechar ou premir novamente o botão.

    Ambiente de criação a mostrar a propriedade Button.OnSelect a chamar Notify e a apresentar a mensagem resultante "Hello, World" ao utilizador numa faixa laranja

  8. Altere o tipo de mensagem para indicar êxito. Altere o segundo argumento da fórmula:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. Clique em ou prima o botão.

    Agora, sempre que se clicar no botão, será apresentada a mensagem de êxito Hello, World ao utilizador. Com um tempo limite de 0, a notificação só será dispensada pelo utilizador ou premindo o botão novamente.

    Ambiente de criação a mostrar a propriedade Button.OnSelect a chamar Notify e a apresentar a mensagem resultante "Hello, World" ao utilizador numa faixa verde

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