Eventos en formularios e cuadrículas en aplicacións baseadas en modelos

Os eventos inician todo o código do lado do cliente. Nas aplicacións baseadas en modelos, asocia unha función específica nunha biblioteca JavaScript (recurso web Script) para ser executada cando ocorre un evento. Esta función denomínase xestor de eventos. Cada xestor de eventos especifica unha única función dentro dunha biblioteca JavaScript e os parámetros que se poden pasar á función.

Só podes asociar xestores de eventos a algúns eventos usando a interface de usuario. Para eventos que non están dispoñibles para ser asociados a través da UI, a API do cliente proporciona métodos que se poden usar para unir xestores de eventos a tales eventos.

Engadir ou eliminar a función do xestor de eventos ao evento usando a interface de usuario

Legado

Use a sección Manexadores de eventos da caixa de diálogo Propiedades do formulario para asociar o script cun evento para formularios e columnas.

Interface unificada

Para engadir ou eliminar funcións de xestor de eventos a eventos na nova Interface Unificada:

1. Vaia a Power Apps.

2. No panel de navegación esquerdo, seleccione Datos e, a seguir, seleccione Táboas.

3. Na lista de táboas, seleccione a táboa na que desexa engadir os xestores de eventos.

4. Seleccione a pestana Formularios na barra de comandos e, a seguir, seleccione o formulario onde desexa engadir.

   

5. Seleccione o separador Eventos . Observa os xestores de eventos On Save e On Load .

   

6. Se desexa engadir o xestor de eventos para o evento ao cambiar, seleccione a columna e, a seguir, seleccione a pestana Evento .

   

Editar formularios en masa

Por defecto, os xestores de eventos non se chaman cando un formulario está en modo de edición masiva.

Para habilitar un xestor de eventos en modo de edición masiva, modifique o XML do formulario buscando o elemento relevante event e creando/establecendo o BehaviorInBulkEditForm atributo en Enabled. Actualmente, isto só se admite para eventos OnLoad.

Para obter máis información sobre a personalización de XML de formulario, consulte Cando editar o ficheiro de personalizacións, Personalizar formularios e o esquema XML de formulario.

Para determinar cando se chama a un xestor de eventos nun formulario en modo de edición masiva, use getFormType o método.

Engadir ou eliminar a función do xestor de eventos ao evento usando o código

Usar os seguintes métodos para engadir e eliminar o xestor de eventos para eventos que non se poden asociar a través da interface de usuario:

Eventos	Xestor de eventos
Atributo onChange	Métodos addOnChange e removeOnChange
Cargar o formulario	formContext.ui addOnLoad e removeOnLoad métodos
Formulario cargado	formContext.ui addLoaded e removeLoaded métodos
Os datos do formulario OnLoad	Métodos formContext.data addOnLoad e removeOnLoad
Formular ao gardar	Métodos addOnSave e removeOnSave
Procura previa do control de procura	Métodos addPreSearch e removePreSearch
control de busca OnResultOpened	Métodos addOnResultOpened e removeOnResultOpened
control de busca por acto OnSelection	Métodos addOnSelection e removeOnSelection
Comando de busca de kbBusca PostSearch	Métodos addOnPostSearch e removeOnPostSearch

Importante

O contexto de execución pasa automaticamente como primeiro parámetro ás funcións que se establecen usando o código. Máis información: Contexto de execución da API do cliente

Pipeline de eventos de formulario

Podes definir ata 50 xestores de eventos para cada evento. Cada xestor de eventos execútase na orde en que se mostra na sección Manexadores de eventos na pestana Eventos da caixa de diálogo Propiedades do formulario .

Use os métodos setSharedVariable e getSharedVariable para pasar unha variable común entre xestores de eventos (funcións). Use o método getDepth do contexto de execución para coñecer a secuencia na que se está a executar un xestor de eventos en relación a outros xestores de eventos.

Artigos relacionados

Comprender o modelo de obxectos API do cliente
Contexto de execución da API do cliente
Eventos (referencia da API do cliente)