Configurar manipuladores de eventos de formulário de aplicação orientada por modelo

Os manipuladores de eventos de formulário para formulários do Power Apps podem ser configurados para as seguintes áreas em um formulário:

Um manipulador de eventos consiste em uma referência a um recurso da Web JavaScript e uma função definida dentro desse recurso da Web que é executada quando o evento ocorre. Cada elemento pode ter até 50 manipuladores de eventos separados configurados.

Configurar um manipulador de eventos

O procedimento a seguir descreve como configurar um manipulador de eventos para um formulário. Use etapas semelhantes para configurar um manipulador de eventos para uma guia, coluna ou IFrame.

1. Inicie sessão no Power Apps, abra a tabela que pretende e, em seguida, abra o formulário no designer de formulários onde pretende configurar um manipulador de eventos.

2. Dependendo do estado da biblioteca, escolha uma das seguintes opções:

   • Se a biblioteca que contém a função que você deseja definir como manipulador de eventos já estiver disponível, no painel de propriedades direito, em Formulário Principal da Conta, selecione a guia Eventos e vá para a etapa 3.
   • Se a biblioteca que contém a função desejada ainda não estiver disponível, selecione Bibliotecas de formulários no painel de navegação esquerdo e, em seguida, selecione Adicionar biblioteca:
     1. Na página Adicionar Biblioteca JavaScript , selecione Novo.
     2. Na nova guia do navegador, conclua as propriedades para criar o recurso da Web JScript e, em seguida, selecione Salvar e, em seguida, selecione Publicar. Para obter mais informações: Criar um recurso da Web JavaScript
     3. Feche a guia do navegador e volte para a lista Adicionar biblioteca JavaScript .
     4. Selecione o recurso da Web JavaScript na lista, selecione Adicionar e, em seguida, selecione a guia Eventos .

     Observação

     Talvez seja necessário selecionar Cancelar e, em seguida, selecionar Adicionar biblioteca para atualizar a lista.

3. Na guia Eventos , selecione Manipulador de Eventos e preencha as seguintes informações para configurar o evento de formulário e, em seguida, selecione Concluído:

   • Tipo de evento:

     • Ao salvar: quando um registro é salvo após uma alteração de campo de formulário.
     • Ao carregar: quando o formulário é aberto.

   • Biblioteca: O recurso da Web JavaScript.

   • Função: O nome da função dentro do recurso da Web JavaScript que deve ser executado para o evento.

   • Habilitado: por padrão, o manipulador de eventos está habilitado. Desmarque a caixa de verificação Ativado se não quiser ativar este evento.

   • Passar o contexto de execução como o primeiro parâmetro: Algumas funções exigem que um contexto de execução seja passado para a função. Selecione Passar contexto de execução como o primeiro parâmetro, se necessário.

   • Lista separada por vírgulas de parâmetros que serão passados para a função: Algumas funções podem aceitar um conjunto de parâmetros para controlar o comportamento de uma função. A lista de parâmetros pode incluir variáveis ou outra função, conforme aceito pelos parâmetros de função permitidos pela linguagem de script JavaScript. Se for necessário passar parâmetros, insira-os na lista separada por vírgulas de parâmetros que serão passados para a função.

   • Dependências das colunas da tabela: Para eventos ao guardar, selecione as colunas nas quais deseja que o evento seja acionado após guardar um registo.

     

4. Guardar e, em seguida, Publicar o formulário.

Exemplo hello world para o evento onload

Este exemplo simples demonstra como configurar um evento de formulário onload usando a passagem de parâmetro de uma única variável definida no manipulador de eventos, que exibe um alerta quando o formulário é carregado.

1. Crie o recurso da Web usando o exemplo de JavaScript Hello world. Para obter mais informações: Criar ou editar recursos da Web de aplicativos controlados por modelo para estender um aplicativo
2. Abra o formulário principal da tabela para edição no designer de formulários. Este exemplo usa o formulário principal da tabela personalizada Student .
3. No painel Informações à esquerda, selecione a guia Eventos .
4. Selecione Adicionar biblioteca, selecione o recurso da Web que você criou (neste exemplo, o recurso é chamado javascript-hello-world) e, em seguida, selecione Adicionar.
5. Selecione Ao carregar para expandi-lo e, em seguida, selecione Manipulador de eventos.
6. No painel Configurar Evento , insira o Nome da função (neste exemplo, helloworld) e, em seguida, na lista separada por vírgulas de parâmetros que serão passados para a caixa de função , insira um parâmetro como n = "Hello world!".
7. Selecione Concluído.
8. Salve e publique o formulário.

Teste o evento executando um aplicativo gerido por modelo que inclui o formulário. Quando o formulário principal é carregado, um alerta exibe a mensagem de diálogo modal "Olá mundo!" Neste exemplo, o usuário deve selecionar OK para descartar o alerta para continuar usando o formulário.

Exemplo de JavaScript do Hello world

function helloworld(n) {
alert(n);
}

Configurar um manipulador de eventos usando a experiência clássica

1. No editor de formulários clássico, selecione o elemento com o evento para o qual você deseja configurar um manipulador.

2. Na guia Página Inicial, no grupo Editar , selecione Alterar Propriedades ou simplesmente clique duas vezes no elemento.

3. Na caixa de diálogo de propriedades do elemento, selecione a guia Eventos .

4. Expanda a área Bibliotecas de formulários . Se a biblioteca que contém a função que você deseja definir como manipulador de eventos ainda não estiver listada, adicione a biblioteca.

5. Para adicionar uma biblioteca de formulários a um manipulador de eventos:

   1. Na seção Bibliotecas de Formulários da Lista de Eventos, selecione Adicionar.

   2. Localize o recurso da Web JavaScript na lista de recursos da Web disponíveis. Selecione-o e, em seguida, selecione Adicionar.

      Se o recurso da Web JavaScript de que você precisa não existir, selecione Novo para abrir um novo formulário de recurso da Web e criar um.

   3. Para criar um recurso da Web JavaScript, consulte Criar um recurso da Web JavaScript.

   4. O recurso da Web que criaste agora está selecionado no diálogo Linha de consulta. Selecione Adicionar para fechar a caixa de diálogo.

6. Na seção Manipuladores de Eventos , selecione o evento para o qual você deseja definir um manipulador de eventos.

7. Selecione Adicionar para abrir a caixa de diálogo Propriedades do manipulador .

8. Na guia Detalhes , escolha a biblioteca apropriada e digite o nome da função que deve ser executada para o evento.

9. Por padrão, o manipulador de eventos está habilitado. Desmarque a caixa de verificação Ativado se não pretender ativar este evento.

   Algumas funções requerem um contexto de execução para serem passadas para a função. Selecione Passar contexto de execução como o primeiro parâmetro, se necessário.

   Algumas funções podem aceitar um conjunto de parâmetros para controlar o comportamento de uma função. Se forem necessários, insira-os na lista de parâmetros separados por vírgulas que serão passados para a função.

10. Na guia Dependências , adicione as colunas das quais o script depende na área Colunas Dependentes .

11. Selecione OK para fechar a caixa de diálogo Propriedade do Processador.

12. Quando o manipulador de eventos é inserido, você pode ajustar a ordem na qual a função é executada em relação a quaisquer outras funções usando as setas verdes para movê-la para cima ou para baixo.

13. Selecione OK para fechar a caixa de diálogo de propriedades do elemento.

14. Selecione Guardar para guardar as alterações. Selecione Publicar para publicar o formulário.

Criar um recurso da Web JavaScript

1. No formulário de recurso da Web, defina as seguintes propriedades:

   Propriedade	Value
   Nome	Obrigatório. Digite o nome do recurso da Web.
   Nome de exibição	Obrigatório. Digite o nome a ser exibido na lista de recursos da Web.
   Description	Opcional. Digite uma descrição do recurso da Web.
   Tipo	Obrigatório. Selecione Script (JScript).
   Linguagem	Opcional. Escolha um dos idiomas disponíveis para a sua organização.

2. Se lhe tiver sido fornecido um script, recomendamos vivamente que utilize o botão Procurar para localizar o ficheiro e carregá-lo.

Como alternativa, você pode selecionar o botão Editor de Texto e colar ou digitar o conteúdo do script na caixa de diálogo Editar conteúdo .

3. Selecione Salvar e feche a página de recursos da Web.

Próximos passos

Passo a passo: Escreva seu primeiro script de cliente
Utilizar o formulário Principal e os respetivos componentes