Função Notify
Aplica-se a:
Aplicativos de tela Aplicativos baseados em modelo CLI do Power Platform
Exibe uma mensagem de faixa para o usuário.
Description
A função Notificar exibe uma mensagem da faixa ao usuário na parte superior da tela. A notificação permanece até que o usuário a descarte, outra notificação a substituirá, ou o tempo limite expirará, cujo padrão é 10 segundos.
Uma cor e um ícone apropriados são usados dependendo do tipo da mensagem. O tipo é especificado pelo segundo argumento para a função:
Nota
O limite de caracteres para a função Notify é de 500 caracteres.
| Argumento NotificationType | Descrição |
|---|---|
| NotificationType.Error | Exibe a mensagem como um erro. |
| NotificationType.Information (padrão) | Exibe a mensagem como informativa. |
| NotificationType.Success | Exibe a mensagem como êxito. |
| NotificationType.Warning | Exibe a mensagem como um aviso. |
As mensagens são exibidas enquanto você cria o aplicativo e quando os usuários finais estão usando o aplicativo.
A função Notify só pode ser usada em fórmulas de comportamento.
A função Notify pode ser emparelhada com a função IfError para detectar e relatar erros em uma mensagem de erro personalizada.
O Power Apps também pode enviar notificações por push usando um mecanismo completamente diferente de Notify. Para obter mais informações, consulte Enviar uma notificação no Power Apps.
Notify sempre retorna true.
Observação: anteriormente essa função era chamada ShowError quando ela só podia exibir mensagens de erro.
Observação
A notificação pode ser usada nas experiências do aplicativo de tela autônomo, página personalizada e comandos do Power Fx. Os valores padrão para NotificationType e Timeout variam de acordo com a experiência em que são usados. Você pode especificar os valores que deseja definir para NotificationType e Timeout definindo-os explicitamente em sua expressão do Power Fx e esses valores serão respeitados independentemente da experiência.
Sintaxe
Notify( Message [, NotificationType [ , Timeout ] ] )
- Message - obrigatório. Mensagem a ser exibida ao usuário.
- NotificationType - opcional. O tipo de mensagem a ser exibido na tabela acima. O padrão é NotificationType.Information.
- Timeout - opcional. Número de milissegundos a aguardar antes de ignorar automaticamente a notificação. O padrão é 10 segundos (ou 10.000 milissegundos). A notificação é exibida indefinidamente com um Tempo limite de 0.
Exemplos
Passo a passo
Adicione um controle Button na tela.
Defina a propriedade OnSelect do Button como a fórmula:
Notify( "Hello, World" )Clique no botão ou pressione-o.
Cada vez que o botão é clicado, a mensagem Olá, Mundo é exibida ao usuário como informativa. Ela será descartada automaticamente em 10 segundos (tempo limite padrão) se o usuário não descartá-la ou pressionar o botão novamente.
Altere o tipo de mensagem para indicar um erro. Adicione um segundo argumento à nossa fórmula:
Notify( "Hello, World", NotificationType.Error )Clique no botão ou pressione-o.
Agora cada vez que o botão é clicado, a mensagem Olá, Mundo é exibida ao usuário como um erro. Ela será descartada automaticamente em 10 segundos (tempo limite padrão) se o usuário não descartá-la ou pressionar o botão novamente.
Altere o tipo de mensagem para indicar um aviso. Altere o segundo argumento em nossa fórmula:
Notify( "Hello, World", NotificationType.Warning, 4000 )Clique no botão ou pressione-o.
Agora cada vez que o botão é clicado, a mensagem Olá, Mundo é exibida ao usuário como um aviso. Ela será descartada automaticamente em 4 segundos (4.000 milissegundos) se o usuário não descartá-la ou pressionar o botão novamente.
Altere o tipo de mensagem para indicar êxito. Altere o segundo argumento em nossa fórmula:
Notify( "Hello, World", NotificationType.Success, 0 )Clique no botão ou pressione-o.
Agora cada vez que o botão é clicado, a mensagem Olá, Mundo é exibida ao usuário como êxito. Com um tempo limite de 0, a notificação só será descartada pelo usuário ou pressionando o botão novamente.
