Eventos em formulários e grades em aplicativos controlados por modelo

Eventos em formulários e grelhas iniciam todo o código do lado do cliente em aplicações orientadas a modelos. Associa-se uma função específica numa biblioteca JavaScript (recurso web Script) a ser executada quando ocorre um evento. Essa função é chamada de manipulador de eventos. Cada manipulador de eventos especifica uma única função dentro de uma biblioteca JavaScript e quaisquer parâmetros que possam ser passados para a função.

Podes associar gestores de eventos apenas a alguns eventos usando a interface. Para eventos que não pode associar através da interface, a API do Cliente fornece métodos que pode usar para anexar handlers de eventos.

Adicionar ou remover funções do gestor de eventos em formulários usando a interface de utilizador

Para adicionar ou remover funções de gestor de eventos para eventos na nova Interface Unificada:

  1. Aceder a Power Apps.

  2. No painel de navegação esquerdo, selecione Dados e, em seguida, selecione Tabelas.

  3. Na lista de tabelas, selecione a tabela onde deseja adicionar os manipuladores de eventos.

  4. Seleciona o separador Formulários na barra de comandos e depois seleciona o formulário onde queres adicionar o gestor de eventos.

    Captura de ecrã do separador Formulários mostrando a lista de formulários para uma tabela no Power Apps.

  5. Seleciona o separador Eventos . Vês tanto os gestores de eventos On Save como On Load .

    Captura de ecrã do separador Eventos mostrando os tratadores de eventos dos formulários On Save e On Load.

  6. Para adicionar um gestor de eventos para o evento de alteração, selecione a coluna e depois selecione o separador Evento .

    Captura de ecrã do separador Eventos da coluna que mostra as definições do handler de eventos On Alterar.

Editar formulários em massa

Por defeito, os gestores de eventos não são executados quando um formulário está em modo de edição em massa.

Para ativar um gestor de eventos em modo de edição em massa, modifique o XML do formulário encontrando o elemento relevante event e criando ou definindo o BehaviorInBulkEditForm atributo para Enabled. Atualmente, este comportamento é suportado apenas para eventos OnLoad.

Para mais informações sobre a personalização do Formulário XML, consulte Quando editar o ficheiro de personalizações, Personalizar formulários e o esquema do Formulário XML.

Para determinar quando um gestor de eventos corre num formulário em modo edição em massa, use o getFormType método.

Adicionar ou remover funções do gestor de eventos usando código API do cliente

Use os seguintes métodos para adicionar e remover gestores de eventos para eventos que não pode associar através da interface:

Events Manipulador de eventos
Atributo OnChange métodos addOnChange e removeOnChange
Formulário OnLoad métodos formContext.ui addOnLoad e removeOnLoad
Formulário carregado métodos formContext.ui addLoaded e removeLoaded
Dados do formulário OnLoad métodos formContext.data addOnLoad e removeOnLoad
Formulário OnSave métodos addOnSave e removeOnSave
Pré-pesquisa de controlo de pesquisa métodos addPreSearch e removePreSearch
controle kbsearch OnResultOpened métodos addOnResultOpened e removeOnResultOpened
controle kbsearch OnSelection métodos addOnSelection e removeOnSelection
controle kbsearch PostSearch métodos addOnPostSearch e removeOnPostSearch

Importante

O contexto de execução é automaticamente passado como o primeiro parâmetro para as funções que defines usando o código. Para mais informações, consulte Contexto de execução da API do cliente.

Pipeline de eventos de formulário

Você pode definir até 50 manipuladores de eventos para cada evento. A secção Gestores de Eventos no separador Eventos da caixa de diálogo Propriedades do Formulário mostra a ordem dos gestores de eventos, e cada gestor de eventos é executado nessa ordem.

Use os métodos setSharedVariable e getSharedVariable para passar uma variável comum entre manipuladores de eventos (funções). Use o método getDepth do contexto de execução para compreender a sequência de execução dos gestores de eventos em relação a outros gestores de eventos.

Compreender o modelo de objeto de API de Cliente
Contexto de execução da API do cliente
Eventos (referência da API do cliente)

  • Última atualização a