calculate-Ereignis

Beschreibung

Wird unter den folgenden Umständen initiiert:

• Wenn der Formularentwurf und die Daten zum fertigen Formular zusammengeführt werden.

• Wenn sich einer der Werte ändert, von denen die Berechnung abhängig ist, z. B. der Wert eines bestimmten Felds, es sei denn, der berechnete Wert wurde beim Ausfüllen des Formulars manuell vom Benutzer überschrieben. Als Ergebnis zeigt das Objekt den Rückgabewert des Ereignisses an. Die Eigenschaften für manuell überschriebene Felder befinden sich auf der Registerkarte „Wert“ der Palette „Objekt“.

• Wenn ein Feld den Fokus verliert, z. B. wenn ein Benutzer klickt oder die Tabulatortaste drückt, um ein Feld zu verlassen.

  Bei Verwendung des calculate-Ereignisses zur Durchführung von Berechnungen oder Skripten ist Folgendes zu beachten:

• Berechnungen und Skripten für das calculate-Ereignis dürfen keine Änderungen an der Formularstruktur vornehmen; davon ausgenommen sind die Formularfeld- und Datenwerte.

• Vom calculate-Ereignis eingefügte Inhalte müssen den zugehörigen Validierungen für das Objekt entsprechen; anderenfalls werden Validierungsfehler gemeldet.

• Berechnungen und Skripten dürfen keine Endlosschleifen enthalten, weil diese dazu führen, dass das Formular den Wert kontinuierlich aktualisiert. Beispielsweise könnte ein Skript, das den Wert eines Felds im Rahmen eines Schleifenausdrucks inkrementiert (z. B. eine Schleife des Typs while oder for ), eine Endlosschleife schaffen.

• Der letzte im calculate-Ereignis ausgewertete Ausdruck wird verwendet, um den Wert des aktuellen Formularobjekts auszufüllen. Beispiel: Wenn das Skript im calculate-Ereignis den Wert des aktuellen Felds zunächst auf 500 einstellt und anschließend den Wert eines weiteren Felds auf 1000 festlegt, zeigen beide Felder zur Laufzeit den Wert 1000 an. Sie müssen daher die Skripten, die Sie zum calculate-Ereignis hinzufügen, auf jene Skripten beschränken, die den Wert des aktuellen Felds einstellen.

Typ

Prozessereignis

Unterstützung

Version

XFA 2.1

Beispiel

Das calculate-Ereignis eignet sich zur Aktualisierung von Zahlenwerten in Feldern, weil es unmittelbar nach den meisten anderen Ereignissen initiiert wird. Beispielsweise könnten Sie in einem Bestellformular mit dem calculate-Ereignis für ein Feld den Prozentwert der Umsatzsteuer anhand der Bestellkosten errechnen. Die Berechnung wird jedes Mal ausgeführt, wenn die Werte in den Formularfeldern geändert werden. Auf diese Weise wird gewährleistet, dass der für die Umsatzsteuer angezeigte Wert immer korrekt ist.

Da das calculate-Ereignis aber viele Male initiiert werden kann, müssen Sie sicherstellen, dass die Berechnung oder das Skript, die bzw. das Sie dem Ereignis hinzufügen, nicht zu einer unnötigen Inkrementierung von Datenwerten führt. Wenn z. B. im Rahmen der Umsatzsteuerberechnung der Wert der Umsatzsteuer den Gesamtkosten bei jeder Initiierung des calculate-Ereignisses hinzugefügt wird, fällt der resultierende Gesamtkostenwert im Formular möglicherweise zu hoch aus.

Ein ausführliches Beispiel zur Verwendung des calculate-Ereignisses finden Sie unter Feldsummen berechnen.