Gebeurtenissen in formulieren en rasters in modelgestuurde apps

Gebeurtenissen initiëren alle code aan de clientzijde. In modelgestuurde apps koppelt u een specifieke functie in een JavaScript-bibliotheek (scriptwebresource) die moet worden uitgevoerd wanneer 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 niet beschikbaar zijn om te worden gekoppeld via de gebruikersinterface, biedt client-API methoden die kunnen worden gebruikt om gebeurtenis-handlers aan dergelijke gebeurtenissen te koppelen.

Gebeurtenis-handlerfunctie toevoegen aan of verwijderen aan gebeurtenis met behulp van de gebruikersinterface

Nalatenschap

Gebruik de sectie Gebeurtenis-handlers van het dialoogvenster Formuliereigenschappen om uw script te koppelen aan een gebeurtenis voor formulieren en kolommen.

Unified Interface

Gebeurtenis-handlerfuncties toevoegen aan of verwijderen uit 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 wilt toevoegen.

   

5. Selecteer het tabblad Gebeurtenissen . Let op zowel de gebeurtenis-handlers On Save als On Load .

   voor formulieren. voor formulieren

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

   

Formulieren bulksgewijs bewerken

Gebeurtenissen-handlers worden standaard niet aangeroepen 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 BehaviorInBulkEditForm kenmerk te maken/in te Enabledstellen op . Dit 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 aangeroepen in een formulier in de modus getFormType bulkbewerking.

Gebeurtenis-handlerfunctie toevoegen aan of verwijderen aan gebeurtenis met behulp van code

Gebruik de volgende methoden om gebeurtenis-handler toe te voegen en te verwijderen voor gebeurtenissen die niet via de gebruikersinterface kunnen worden gekoppeld:

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 voor functies die zijn ingesteld met behulp van de code. Meer informatie: Uitvoeringscontext client-API

Pijplijn voor formulierevenementen

U kunt maximaal 50 gebeurtenis-handlers definiëren voor elke gebeurtenis. Elke gebeurtenis-handler wordt uitgevoerd in de volgorde waarin deze wordt weergegeven in de sectie Gebeurtenis-handlers op het tabblad Gebeurtenissen van het dialoogvenster Formuliereigenschappen .

Gebruik de setSharedVariable en getSharedVariable-methoden om een algemene variabele door te geven tussen gebeurtenis-handlers (functies). Gebruik de getDepth-methode voor de uitvoering om te weten welke volgorde een gebeurtenis-handler wordt uitgevoerd ten opzichte van andere gebeurtenis-handlers.

Verwante artikelen

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