Gebeurtenissen in formulieren en rasters in modelgestuurde apps

Gebeurtenissen in formulieren en rasters initiëren alle code aan de clientzijde in modelgestuurde apps. U koppelt een specifieke functie in een JavaScript-bibliotheek (scriptwebresource) die moet worden uitgevoerd wanneer er een gebeurtenis plaatsvindt. Deze functie wordt een gebeurtenis-handler genoemd. Elke gebeurtenis-handler specificeert één functie in een JavaScript-bibliotheek en parameters die aan de functie kunnen worden doorgegeven.

U kunt gebeurtenis-handlers koppelen aan slechts enkele gebeurtenissen met behulp van de gebruikersinterface. Voor gebeurtenissen die u niet via de gebruikersinterface kunt koppelen, biedt client-API methoden die u kunt gebruiken om gebeurtenis-handlers te koppelen.

Gebeurtenis-handlerfuncties toevoegen aan of verwijderen in formulieren met behulp van de gebruikersinterface

Ga als volgt te werk om gebeurtenis-handlerfuncties toe te voegen of te verwijderen voor gebeurtenissen in de nieuwe Unified Interface:

  1. Ga naar Power Apps.

  2. Selecteer gegevens in het linkernavigatiedeelvenster en selecteer vervolgens Tabellen.

  3. Selecteer in de lijst met tabellen de tabel waaraan u de gebeurtenis-handlers wilt toevoegen.

  4. Selecteer het tabblad Formulieren op de opdrachtbalk en selecteer vervolgens het formulier waaraan u de gebeurtenis-handler wilt toevoegen.

    Schermopname van het tabblad Formulieren met de lijst met formulieren voor een tabel in Power Apps.

  5. Selecteer het tabblad Gebeurtenissen . U ziet zowel de gebeurtenis-handlers On Save als On Load .

    Schermopname van het tabblad Gebeurtenissen met de gebeurtenis-handlers Voor opslaan en Bij laden van formulier.

  6. Als u een gebeurtenis-handler wilt toevoegen voor de wijzigings gebeurtenis, selecteert u de kolom en selecteert u vervolgens het tabblad Gebeurtenis .

    Schermopname van het tabblad Gebeurtenissen in de kolom met de instellingen voor gebeurtenis-handler Bij wijzigen.

Formulieren bulksgewijs bewerken

Gebeurtenis-handlers worden standaard niet uitgevoerd wanneer een formulier bulkbewerkingsmodus heeft.

Als u een gebeurtenis-handler in de bulkbewerkingsmodus wilt inschakelen, wijzigt u de XML van het formulier door het relevante event element te zoeken en het kenmerk te maken of in BehaviorInBulkEditForm te Enabledstellen op . Dit gedrag wordt momenteel alleen ondersteund voor OnLoad-gebeurtenissen.

Zie Wanneer u het aanpassingenbestand bewerkt, formulieren aanpassen en het XML-schema van het formulier voor meer informatie over het aanpassen van formulier-XML.

Gebruik de methode om te bepalen wanneer een gebeurtenis-handler wordt uitgevoerd op een formulier in de getFormType modus bulkbewerking.

Gebeurtenis-handlerfuncties toevoegen of verwijderen met behulp van client-API-code

Gebruik de volgende methoden om gebeurtenis-handlers toe te voegen en te verwijderen voor gebeurtenissen die u niet via de gebruikersinterface kunt koppelen:

Evenementen Gebeurtenishandler
Kenmerk OnChange addOnChange- en removeOnChange-methoden
Formulier bij laden addOnLoad- en removeOnLoad-methoden formContext.ui
Formulier geladen addLoaded- en removeLoaded-methoden voor formContext.ui
Formuliergegevens Bij laden formContext.data addOnLoad- en removeOnLoad-methoden
Formulier onSave addOnSave- en removeOnSave-methoden
Zoekbesturingselement PreSearch addPreSearch- en removePreSearch-methoden
kbsearch-besturingselement OnResultOpened addOnResultOpened en removeOnResultOpened-methoden
kbsearch-besturingselement OnSelection addOnSelection- en removeOnSelection-methoden
kbsearch-besturingselement PostSearch addOnPostSearch en removeOnPostSearch-methoden

Belangrijk

De uitvoeringscontext wordt automatisch doorgegeven als de eerste parameter aan functies die u instelt met behulp van de code. Zie de context voor uitvoering van client-API's voor meer informatie.

Pijplijn voor formulierevenementen

U kunt maximaal 50 gebeurtenis-handlers definiëren voor elke gebeurtenis. In de sectie Gebeurtenis-handlers op het tabblad Gebeurtenissen van het dialoogvenster Formuliereigenschappen ziet u de volgorde van gebeurtenis-handlers en wordt elke gebeurtenis-handler in die volgorde uitgevoerd.

Gebruik de setSharedVariable en getSharedVariable-methoden om een algemene variabele door te geven tussen gebeurtenis-handlers (functies). Gebruik de getDepth-methode voor de uitvoeringscontext om inzicht te krijgen in de volgorde van de uitvoering van de gebeurtenis-handler ten opzichte van andere gebeurtenis-handlers.

Inzicht in het client-API-objectmodel
Uitvoeringscontext client-API
Gebeurtenissen (client-API-verwijzing)

  • Laatst bijgewerkt om