Função Notify
Aplica-se a: Aplicações de tela Aplicações condicionadas por modelo CLI do Power Platform
Apresenta uma mensagem em faixa ao utilizador.
Description
A função Notify apresenta uma mensagem em faixa ao utilizador na parte superior do ecrã. A notificação permanece até que o utilizador a descarte 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:
Nota
O limite de caracteres para a função Notify é de 500 caracteres.
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.
Nota
A notificação pode ser utilizada na aplicação de tela autónoma, página personalizada e experiências de comandos do Power Fx . Os valores predefinidos para NotificationType e Timeout variam de acordo com a experiência em que são utilizados. Pode especificar os valores que pretende definir para NotificationType e Timeout definindo-os explicitamente na sua expressão do Power Fx, sendo que estes valores serão respeitados independentemente da experiência.
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 é apresentada indefinidamente com um Timeout de 0.
Exemplos
Passo a passo
Adicione um controlo Button ao seu ecrã.
Defina a propriedade OnSelect do Botão como a fórmula:
Notify( "Hello, World" )
Clique em ou prima o botão.
Sempre que se clicar no botão, será apresentada a mensagem informativa Hello, World ao utilizador. Descarta automaticamente em 10 segundos (tempo limite predefinido) se o utilizador não o descartar ou premir novamente o botão.
Altere o tipo de mensagem para indicar um erro. Adicione um segundo argumento à fórmula:
Notify( "Hello, World", NotificationType.Error )
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. Descarta automaticamente em 10 segundos (tempo limite predefinido) se o utilizador não o descartar ou premir novamente o botão.
Altere o tipo de mensagem para indicar um aviso. Altere o segundo argumento da fórmula:
Notify( "Hello, World", NotificationType.Warning, 4000 )
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. Descarta automaticamente em 4 segundos (4.000 milisegundos) se o utilizador não o descartar ou premir novamente o botão.
Altere o tipo de mensagem para indicar êxito. Altere o segundo argumento da fórmula:
Notify( "Hello, World", NotificationType.Success, 0 )
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.