calculate (gebeurtenis)

Beschrijving

Deze gebeurtenis wordt in de volgende situaties gestart:

• Wanneer een formulierontwerp en gegevens in het voltooide formulier worden samengevoegd.

• Wanneer een wijziging optreedt in een waarde die van belang is voor de berekening, zoals de waarde van een bepaald veld, tenzij de gebruiker de berekende waarde handmatig heeft overschreven. Als gevolg hiervan wordt de geretourneerde waarde van de gebeurtenis weergegeven in het object. De eigenschappen voor handmatig overschreven velden bevinden zich op het tabblad Waarde van het palet Object.

• Wanneer de focus van een veld verdwijnt, bijvoorbeeld wanneer een gebruiker klikt of de Tab-toets gebruikt om naar een ander veld te gaan.

  Als u de calculate-gebeurtenis gebruikt om berekeningen of scripts uit te voeren, moet u met de volgende potentiële problemen rekening houden:

• Berekeningen en scripts op de calculate-gebeurtenis mogen niet tot wijzigingen in de structuur van het formulier leiden, behalve voor het formulierveld en de gegevenswaarden.

• Inhoud die met de calculate-gebeurtenis wordt ingevoegd, moet voldoen aan de validaties die bij het object horen. Als dit niet het geval is, treden validatiefouten op.

• Berekeningen en scripts mogen geen oneindige lus bevatten, omdat de waarde dan continu door het formulier wordt bijgewerkt. Er kan bijvoorbeeld een oneindige lus ontstaan door een script dat de waarde van een veld ophoogt via een lusexpressie, zoals een while- of for-lus.

• De laatste expressie die wordt geëvalueerd in de gebeurtenis calculate, wordt gebruikt om de waarde van het huidige formulierobject in te vullen. Als bijvoorbeeld het script op de gebeurtenis calculate de waarde van het huidige veld eerst instelt op 500 en vervolgens de waarde van een ander veld instelt op 1000, wordt bij de uitvoering in beide velden de waarde 1000 weergegeven. Dit betekent dat u het script dat u toevoegt aan de gebeurtenis calculate, moet beperken tot de elementen die specifiek betrekking hebben op het instellen van de waarde van het huidige veld.

Type

Procesgebeurtenis

Ondersteuning

Versie

XFA 2.1

Voorbeeld

U kunt de calculate-gebeurtenis gebruiken voor het bijwerken van numerieke waarden in velden, omdat deze gebeurtenis direct na de meeste andere gebeurtenissen wordt gestart. Op een inkooporderformulier kunt u de calculate-gebeurtenis voor een veld bijvoorbeeld gebruiken om het percentage verschuldigde BTW te bepalen op basis van de totale kosten van de order. De berekening wordt telkens gestart wanneer een wijziging optreedt in de waarden in de formuliervelden, zodat altijd een correcte waarde voor de BTW wordt weergegeven.

Aangezien de calculate-gebeurtenis echter meerdere malen kan worden gestart, moet u ervoor zorgen dat de berekening die of het script dat u aan de gebeurtenis toevoegt, er niet voor zorgt dat gegevenswaarden onnodig worden opgehoogd. Als bijvoorbeeld de berekening van de BTW ervoor zorgt dat de waarde van de BTW telkens aan de totale kosten wordt toegevoegd wanneer de calculate-gebeurtenis wordt gestart, wordt de resulterende waarde voor de totale kosten op het formulier mogelijk te hoog.

Zie De veldsommen berekenen voor een gedetailleerd voorbeeld van het gebruik van de gebeurtenis calculate.