Erstellen eines Ereignishandlers

Wichtig :  Dieser Artikel wurde maschinell übersetzt. Bitte beachten Sie den Haftungsausschluss. Die englische Version des Artikels ist als Referenz hier verfügbar: hier.

Beim Erstellen von Skripts für eine Microsoft Office InfoPath-Formularvorlage, Schreiben Sie normalerweise Code in des Formulars eine Vorlage oder Daten Überprüfung Ereignishandler. Ein Ereignishandler ist der Funktionscode in einem InfoPath-Formular, das auf eine Benutzeraktion oder eine Änderung der XML-Daten in einem Formular reagiert. Erstellen Sie einen Ereignishandler, hängt von den Typ des Ereignisses, die Sie verwenden möchten. Es ist wichtig, den Ereignishandler im Entwurfsmodus erstellt werden, da InfoPath automatisch die Deklarationen der Ereignishandler in der Skriptdatei erstellt und Einträge in der () MSE, mit denen eine Formularvorlage diese Ereignishandler verwenden können.

Hinweis : Obwohl die Ereignishandler manuell in der Skriptdatei erstellt werden können und dann durch manuelles Hinzufügen der entsprechenden Elemente zur XSF-Datei aktiviert werden können, ist dies nicht empfehlenswert. Durch das Vornehmen einer ungültigen Änderung an der XSF-Datei könnte die Formularvorlage unbrauchbar werden.

Die folgenden Tabelle sind alle InfoPath-Ereignishandler und die Schritte zum Erstellen können. Wenn Sie einen Ereignishandler für eine Formularvorlage erstellen, InfoPath beginnt Microsoft Script Editor (MSE), und stellen den Cursor in den Code für diesen Ereignishandler. Anschließend können Sie das Skript für den Ereignishandler schreiben. Ausführliche Informationen zu InfoPath-Ereignisse und Ereignishandler finden Sie unter der InfoPath Referenz für Entwickler, die in der MSE-Hilfe zur Verfügung steht.

Event handler

Description

Steps for creating

OnAfterChange

Dieses Ereignis wird ausgeführt, nachdem ein Benutzer den Wert in der angegebenen an ein Feld gebundenes Steuerelement ändert. Beispielsweise können Sie einen benutzerdefinierten HTML-Aufgabenbereich anzeigen, nachdem ein Benutzer ein Element in einem Listenfeld-Steuerelement ausgewählt. Dieses Ereignis wird nach dem Ereignis OnValidate ausgeführt.

Klicken Sie mit der rechten Maustaste auf ein Steuerelement auf der Formularvorlage oder ein Feld im Aufgabenbereich Datenquelle, zeigen Sie im Kontextmenü auf Programmierung, und klicken Sie auf On After Change-Ereignis.

OnAfterImport

Dieses Ereignis wird ausgeführt, nachdem der Benutzer mehrere Formulare in einem Formular zusammengeführt hat.

Manuell hinzufügen der OnAfterImport Ereignishandlerdeklaration direkt an die Skriptdatei mithilfe von MSE ein. Dieser Ereignishandler kann nicht im Entwurfsmodus erstellt werden.

OnBeforeChange

Dieses Ereignis wird ausgeführt, wenn ein Benutzer den Wert in einem Steuerelement ändert und bevor der Wert in dem an dieses Steuerfeld gebundene Feld hinzugefügt wurde. Sie können z. B. verhindern, dass ein Benutzer eine zusätzliche Zeile hinzufügt, bevor er die letzte Zeile in einer wiederholten Tabelle ausgefüllt hat.

Klicken Sie mit der rechten Maustaste auf ein Steuerelement auf der Formularvorlage oder ein Feld im Aufgabenbereich Datenquelle, zeigen Sie im Kontextmenü auf Programmierung, und klicken Sie auf On Before Change-Ereignis.

OnClick

Dieses Ereignis wird ausgeführt, wenn ein Benutzer auf eine diesem Ereignis zugeordnete Schaltfläche klickt . Dieses Ereignis ist nach dem Hinzufügen einer Schaltfläche zu der Formularvorlage verfügbar. Sie können z. B. eine komplizierte Berechnung mithilfe der Werte in den Feldern in der Hauptdatenquelle ausführen, wenn ein Benutzer auf die Schaltfläche klickt.

Doppelklicken Sie auf das Schaltflächen-Steuerelement und anschließend auf die Registerkarte Allgemein im Dialogfeld Schaltflächeneigenschaften, klicken Sie auf Formularcode bearbeiten.

OnContextChange

Dieses Ereignis wird jedesmal ausgeführt, wenn im Formular der Fokus wechselt. So wird es z. B: dann ausgeführt, wenn ein Benutzer von einem Textfeld zu einer Datumsauswahl wechselt, oder wenn ein Benutzer die Ansicht ändert. Dieses Ereignis wird nach allen anderen Ereignissen ausgeführt.

Zeigen Sie im Menü Extras auf Programmierung, und klicken Sie anschließend auf On Context Change-Ereignis.

OnLoad

Dieses Ereignis wird ausgeführt, wenn ein Benutzer ein neues Formular erstellt oder ein vorhandenes Formular basierend auf der Formularvorlage geöffnet. Beispielsweise können Sie kopieren eine Liste von Elementen aus einer sekundären Datenquelle in der primären Datenquelle, wenn ein Benutzer auf das Formular geöffnet wird.

Zeigen Sie im Menü Extras auf Programmierung, und klicken Sie anschließend auf On Load-Ereignis.

OnMergeRequest

Dieses Ereignis wird ausgeführt, wenn Formulare, die auf Ihrer Formularvorlage basieren, zusammengeführt werden. Sie können z. B. die Anzahl der zusammengeführten Formulare anzeigen, um dem Benutzer während des Zusammenführungsvorgangs eine Statusinformationen zu geben.

Klicken Sie im Menü Extras auf Formularoptionen. Klicken Sie in der Liste Kategorie auf Erweitert. Aktivieren Sie unter Formulare zusammenführen das Kontrollkästchen Mithilfe benutzerdefiniertem Code zusammenführen, und klicken Sie anschließend auf Bearbeiten.

OnSaveRequest

Dieses Ereignis wird ausgeführt, wenn ein Benutzer ein Formular basierend auf Ihrer Formularvorlage speichert. Beispielsweise können Sie das Formular basierend auf dieser Formularvorlage an mehr als einem Speicherort, wenn ein Benutzer das Formular speichert speichern. InfoPath fügt zwei zusätzliche Codezeilen dieses Ereignis: eine Linie, die im Formular und eine weitere Zeile speichert erfahren Sie, wenn das Formular in InfoPath erfolgreich gespeichert haben.

Klicken Sie im Menü Extras auf Formularoptionen. Klicken Sie in der Liste Kategorie auf Öffnen und speichern. Aktivieren Sie unter Verhalten beim Speichern das Kontrollkästchen Speichern erfolgt mittels benutzerdefiniertem Code, und klicken Sie anschließend auf Bearbeiten.

OnSign

Dieses Ereignis wird ausgeführt, wenn ein Benutzer ein Formular digital signiert. Sie können z. B. der digitalen Signatur eines Kostenberichtsformulars zusätzliche Daten hinzufügen, wenn der Benutzer das Formular unterschreibt.

Klicken Sie im Menü ExtrasProgramming zeigen Sie, und klicken Sie dann auf Sign-Ereignis.

OnSubmitRequest

Dieses Ereignis wird ausgeführt, wenn ein Benutzer Formulardaten absendet. Sie können z. B. die Formulardaten an einen sicheren Webdienst senden, wenn der Benutzer im Menü Datei auf Absenden klickt. Da InfoPath eine Datenverbindung zu einem sicheren Webdienst nicht unterstützt, müssen Sie eine benutzerdefinierte Datenverbindung hinzufügen, die mit Ihrem sicheren Webdienst funktioniert.

Klicken Sie im Menü Extras auf Optionen zum Absenden. Wählen Sie das Kontrollkästchen Benutzern erlauben, senden Sie dieses Formular aus, klicken Sie auf benutzerdefinierte Aktion mithilfe von Code ausführen, und klicken Sie dann auf Code bearbeiten.

OnSwitchView

Dieses Ereignis wird ausgeführt, wenn ein Benutzer ein auf Ihrer Formularvorlage basierendes Formular öffnet oder in eine andere Ansicht im Formular wechselt. Sie können z. B., wenn ein Benutzer in eine bestimmte Ansicht wechselt, eine E-Mail-Nachricht erstellen, die die Daten aus den Feldern in der Hauptdatenquelle des Formulars enthält.

Zeigen Sie im Menü Extras auf Programmierung, und klicken Sie anschließend auf On Switch View-Ereignis.

OnValidate

Dieses Ereignis wird ausgeführt, wenn ein Benutzer den Wert in einem Steuerelement an ein Feld gebunden ändert. Angenommen, wenn der Benutzer den Wert in einem bestimmten Steuerelement ändert, können Sie berechnen einen neuen Wert für ein anderes Steuerelement mithilfe der die vom Benutzer eingegebene Zahl und einer Zahl zurück, die das Skript ist. Dieses Ereignis tritt auf, nachdem die eventObj ausgeführt wird.

Klicken Sie mit der rechten Maustaste auf ein Steuerelement auf der Formularvorlage oder ein Feld im Aufgabenbereich Datenquelle, zeigen Sie im Kontextmenü auf Programmierung, und klicken Sie auf On After Validate-Ereignis.

OnVersionUpgrade

Dieses Ereignis wird ausgeführt, wenn ein Benutzer ein vorhandenes Formular öffnet und die Versionsnummer der Formularvorlage vom vorhandenen Formular verwendeten älter als die Versionsnummer der Formularvorlage Speicherort veröffentlichen ist. Wenn ein Benutzer ein vorhandenes Formular öffnet, überprüft InfoPath die Versionsnummer der Formularvorlage das vorhandene Formular zugeordnet. Wenn die Formularvorlage eine neuere Versionsnummer aufweist, führt InfoPath Ereignishandler OnVersion aus, wenn der Benutzer das vorhandene Formular öffnet. Angenommen Sie, dass Sie beim Hinzufügen eines neuen Felds zu einer vorhandenen Formularvorlage und erneut veröffentlichen, und das neue Feld ein, wenn ein Benutzer ein vorhandenes Formular öffnet der primären Datenquelle hinzugefügt werden soll. Dieses Ereignis fügt das neue Feld in der primären Datenquelle, wenn ein Benutzer ein vorhandenes Formular öffnet.

Klicken Sie im Menü Extras auf Formularoptionen. Klicken Sie in der Liste Kategorie auf Versionskontrolle. Klicken Sie in der Liste Bei Versionsaktualisierung auf Benutzerdefiniertes Ereignis verwenden, und klicken Sie anschließend auf Bearbeiten.

Hinweis : Haftungsausschluss für maschinelle Übersetzungen: Dieser Artikel wurde mithilfe eines Computersystems und ohne jegliche Bearbeitung durch Personen übersetzt. Microsoft bietet solche maschinellen Übersetzungen als Hilfestellung für Benutzer ohne Englischkenntnisse an, damit Sie von den Informationen zu Produkten, Diensten und Technologien von Microsoft profitieren können. Da es sich bei diesem Artikel um eine maschinelle Übersetzung handelt, enthält er möglicherweise Fehler in Bezug auf (Fach-)Terminologie, Syntax und/oder Grammatik.

Ihre Fähigkeiten erweitern
Schulung erkunden
Neue Funktionen als Erster erhalten
An Office Insider teilnehmen

War diese Information hilfreich?

Vielen Dank für Ihr Feedback!

Vielen Dank für Ihr Feedback. Es klingt, als ob es hilfreich sein könnte, Sie mit einem unserer Office-Supportmitarbeiter zu verbinden.

×