Configurar controladores de eventos de formularios principais en aplicacións controladas por modelos

Os controladores de eventos para formularios de Power Apps poden configurarse para as seguintes áreas nun formulario:

Elemento Evento Descrición
Formulario OnLoad Prodúcese cando se carga o formulario.
OnSave Prodúcese cando se gardan os datos.
Separador TabStateChange Prodúcese cando se expande ou cando se contrae o separador.
Campo OnChange Prodúcese cando os datos no campo modifícanse e o control perde enfoque.
IFRAME OnReadyStateComplete Prodúcese cando se carga o contido dun IFRAME.

Un controlador de eventos consiste nunha referencia a un recurso web de JavaScript e nunha función definida nese recurso web que se executará cando se produza o evento. Cada elemento poden ter até 50 controladores de eventos independentes configurados.

Importante

Configurar un controlador de eventos incorrectamente poden provocar erros de script que poden causar que o formulario non cargue ou non funcione correctamente. Se non é o programador do script, asegúrese de comprender exactamente que opcións de configuración require o script.

Non configure un controlador de eventos de script mediante unha biblioteca que non provén dunha orixe na que confía. Os scripts poden usarse para realizar calquera acción que pode realizar un usuario e un script pobre pode danar significativamente o desempeño dun formulario.

Despois de configurar un controlador de eventos próbeo sempre para comprobar que funciona correctamente.

Para configurar un controlador de eventos

  1. No editor de formularios, seleccione o elemento co evento para o que quere configurar o controlador.

  2. No separador Inicio, no grupo Editar, seleccione Modificar propiedades ou simplemente prema dúas veces o elemento.

  3. No diálogo de propiedades do elemento, seleccione o separador Eventos.

  4. Expanda a área Bibliotecas de formularios. Se a biblioteca que contén a función que quere definir como o controlador de eventos aínda non aparece, engada a biblioteca.

  5. Para engadir unha biblioteca de formularios a un controlador de eventos:

    1. Na sección Bibliotecas de formularios da Lista de eventos, seleccione Engadir.

    2. Localice o recurso web de JavaScript na lista de recursos web dispoñibles. Seleccióneo e, a seguir, seleccione Engadir.

      Se o recurso web de JavaScript que precisa non existe, seleccione Novo para abrir un novo formulario de recurso web e crear un.

    3. Para crear un recurso web de JavaScript:

      1. No formulario do recurso web configure as propiedades seguintes:

        Propiedade Valor
        Nome Necesario. Escriba o nome do recurso web.
        Nome para mostrar Necesario. Escriba o nome que se mostrará na lista de recursos web.
        Descrición Opcional. Escriba unha descrición do recurso web.
        Tipo Necesario. Seleccione Script (JScript).
        Idioma Opcional. Escolla un dos idiomas dispoñibles para a súa organización.
      2. Se se lle forneceu un script, recomendámoslle que use o botón Explorar para localizar o ficheiro e cargalo.

        Se non, tamén pode seleccionar o botón Editor de texto e pegar ou escribir o contido do script no diálogo Editar contido.

        Nota

        Debido a que este editor de texto non fornece ningunha funcionalidade para comprobar a corrección do script, deberá tentar usar sempre unha aplicación independente como Visual Studio para editar scripts e, a seguir, cargalos.

      3. Seleccione Gardar e peche o diálogo do recurso web.

      4. O recurso web que creou seleccionouse no diálogo Buscar rexistro. Seleccione Engadir para pechar a caixa de diálogo.

  6. Na Controladores de eventos, seleccione o evento para o que quere definir un controlador de eventos.

  7. Seleccione Engadir para abrir o diálogo Propiedades do controlador.

  8. No separador Detalles escolla a biblioteca adecuada e escriba o nome da función que debería executarse para o evento.

  9. Por defecto, o controlador de eventos está activado. Desmarque a caixa de verificación Activado se non quere activar este evento.

    Algunhas funcións requiren un contexto de execución para que se transmita á función. Seleccione Pasar contexto de execución como primeiro parámetro, se é necesario.

    Algunhas funcións poden aceptar un conxunto de parámetros para controlar o comportamento dunha función. Se estas son necesarias, introdúzaas en Lista de parámetros separados por comas que se pasará á función.

  10. No separador Dependencias, engada os campos dos que depende o script na área Campos dependentes.

  11. Seleccione Aceptar para pechar a caixa de diálogo Propiedades do controlador.

  12. Cando se introduza o controlador de eventos, é posible que teña que axustar a orde na que se executará a función en relación a calquera outra función mediante as frechas verdes para movela cara abaixo ou cara arriba.

  13. Seleccione Aceptar para pechar o diálogo das propiedades do elemento.

  14. Seleccione Gardar para gardar as modificacións. Seleccione Publicar para publicar o formulario.

Nota

Aínda que a interface de usuario (IU) lle permite axustar a orde en que as secuencias de comandos se cargan mediante as frechas verdes cara arriba e cara abaixo, as secuencias de comandos en realidade non se cargan en orde.

Seguintes pasos

Utilice o formulario Principal e os seus compoñentes