Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
Aplicativos de tela Baseados em modelos da CLI do Power Platform
Exibe uma mensagem de faixa para o usuário.
Description
A Notify função exibe uma mensagem de faixa para o 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 Notify a função é de 500 caracteres.
| Argumento NotificationType | Description |
|---|---|
| Tipo de notificação.Erro | Exibe a mensagem como um erro. |
| NotificationType.Information (Padrão) | Exibe a mensagem como informativa. |
| Tipo de notificação.Sucesso | Exibe a mensagem como êxito. |
| Tipo de notificação.Aviso | 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.
Notify só pode ser usado em fórmulas de comportamento.
Notify pode ser emparelhado com a função IfError para detectar 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 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.
Nota
Notify pode ser usado em aplicativos de tela autônomos, página personalizada e experiências de comando 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( Mensagem [, NotificationType [ , Tempo limite ] ] )
- Mensagem – 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.
- Tempo limite – 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.
