Ereignisse in Formularen und in Rastern in Modell-angetriebenen Apps

Ereignisse initiieren den gesamten clientseitigen Code. In Modell-angetriebenen Apps verknüpfen Sie eine spezielle Funktionen in einer JavaScript-Bibliothek (Skriptwebressource), das ausgeführt werden soll, wenn ein Ereignis auftritt. Diese Funktion wird als Ereignishandler bezeichnet. Jeder Ereignishandler gibt eine Funktion innerhalb einer einzelnen JavaScript-Bibliothek und alle Parameter an, die an die Funktion übergeben werden können.

Sie können Ereignishandler nur einigen Ereignissen mit der Benutzeroberfläche zuordnen. Für Ereignisse, die nicht über die Benutzeroberfläche verknüpft werden können, stellt die Client-API Methoden bereit, mit denen Ereignishandler an solche Ereignisse angehängt werden können.

Hinzufügen oder Entfernen von Ereignishandlerfunktion zum Ereignis mit der Benutzeroberfläche

Veraltet

Verwenden Sie den Absschnitt Ereignishandler des Dialogfelds Formulareigenschaften zum Verknüpfen Ihres Skripts mit einem Ereignis für Formulare und Spalten.

Einheitliche Oberfläche

Um Ereignis-Handler-Funktionen zu Ereignissen in der neuen Einheitlichen Benutzeroberfläche hinzuzufügen oder zu entfernen:

1. Wechseln Sie zu Power Apps.

2. Wählen Sie im linken Navigationsbereich Daten und wählen Sie dann Tabellen.

3. Wählen Sie aus der Liste der Tabellen die Tabelle aus, in der Sie die Ereignis-Handler hinzufügen möchten.

4. Wählen Sie in der Befehlsleiste die Registerkarte Formulare und wählen Sie dann das Formular, das Sie hinzufügen möchten.

   

5. Auswählen-Registerkarte Ereignisse . Beachten Sie sowohl die Ereignishandler Beim Speichern als auch Beim Laden .

   

6. Wenn Sie den Ereignishandler für das Ereignis bei Änderung hinzufügen möchten, wählen Sie die Spalte aus und wählen Sie dann die Registerkarte Ereignis.

   

Massenbearbeitung von Formularen

Standardmäßig werden Ereignishandler nicht aufgerufen, wenn ein Formular im Massenbearbeitungsmodus ist.

Um einen Ereignishandler in Massenbearbeitungsmodus zu aktivieren, ändern Sie die Formular-XML, indem Sie das entsprechende event-Element und das BehaviorInBulkEditForm-Attribut erstellen bzw. auf Enabled festlegen. Derzeit wird dies nur für OnLoad-Ereignisse unterstützt.

Weitere Informationen zur Anpassung von Formular-XML finden Sie unter Wann die Anpassungsdatei bearbeitet werden muss, Formulare anpassen und das Formular XML-Schema.

Um festzustellen, wann ein Ereignishandler in einem Formular im Massenbearbeitungsmodus aufgerufen wird, verwenden Sie die getFormType-Methode.

Hinzufügen oder Entfernen von Ereignishandlerfunktion zum Ereignis mit Code

Verwenden Sie die folgenden Methoden, um Ereignishandler für Ereignisse hinzuzufügen und zu entfernen, die nicht über die Benutzeroberfläche verknüpft werden können:

Veranstaltungen	Ereignishandler
Attribut OnChange	addOnChange und removeOnChange-Methoden
Formular OnLoad	formContext.ui und addOnLoad und removeOnLoad-Methoden
Formular Geladen	formContext.ui addLoaded und removeLoaded Methoden
Formulardaten OnLoad	formContext.data addOnLoad und removeOnLoad-Methoden
Formular OnSave	addOnSave und removeOnSave-Methoden
Nachschlagesteuerung PreSearch	addPreSearch und removePreSearch-Methoden
kbsearch Steuerelement OnResultOpened	addOnResultOpened und removeOnResultOpened-Methoden
kbsearch Steuerelement OnSelection	addOnSelection und removeOnSelection-Methoden
kbsearch Steuerelement PostSearch	addOnPostSearch und removeOnPostSearch-Methoden

Wichtig

Der Ausführungskontext wird automatisch bei der ersten der zu den Funktionen übergeben, die mithilfe des Codes festgelegt wird. Weitere Informationen: Client API-Ausführungskontext

Formularereignispipeline

Sie können bis 50 Ereignsihandler für jedes Ereignis definieren. Jeder Ereignishandler wird in der Reihenfolge ausgeführt, in der er im Abschnitt Ereignishandler auf der Registerkarte Ereignisse des Dialogfelds Formulareigenschaften angezeigt wird.

Verwenden Sie die setSharedVariable und getSharedVariable-Methoden, um eine gemeinsam genutzte Variable zwischen Erreignishndlern (Funktionen) zu übergeben. Verwenden Sie die Ausführungskontextmethode getDepth, um die Sequenz zu ermitteln, in der ein Ereignishandler relativ zu anderen Handlern ausgeführt wird.

Ähnliche Artikel

Grundlegendes zum Client API-Objektmodell
Client-API-Ausführungskontext
Ereignissse (Client-API-Referenz)

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).