Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
Aplicativos de tela Aplicativos orientados por modelo CLI da Power Platform
Apresenta uma mensagem em faixa ao utilizador.
Description
A Notify função exibe uma mensagem de banner para o usuário na parte superior da tela. 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 Notify a função é de 500 caracteres.
| Argumento NotificationType | Description |
|---|---|
| NotificationType.Error | Apresenta uma mensagem de erro. |
| NotificationType.Information (Padrã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.
Notify só pode ser usado em fórmulas de comportamento.
Notify pode ser emparelhado com a função IfError para detetar e relatar erros com uma mensagem de erro personalizada.
O Power Apps também pode enviar notificações por push usando um mecanismo totalmente diferente do Notify. Para mais informações, consulte Enviar uma notificação no Power Apps.
Notify sempre retorna true.
Nota: esta função tinha anteriormente a designação ShowError, uma vez que só podia apresentar mensagens de erro.
Nota
Notify pode ser usado em aplicativos de tela autônomos, páginas personalizadas e experiências de comando 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 [ , Tempo limite ] ] )
- 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.
- Tempo limite – 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.
