calculate (händelse)

Beskrivning

Startar i följande situationer:

• När formulärdesign sammanfogas med data till ett färdigt formulär.

• När ett värde som beräkningen är beroende av ändras, t ex värdet för ett bestämt fält, såvida inte formuläranvändaren har åsidosatt det beräknade värdet manuellt. Objektet kommer att visa det returnerade värdet för händelsen. Du hittar egenskaperna för manuellt åsidosatta fält på fliken Värde på paletten Objekt.

• När ett fält tappar fokus, t ex när en formuläranvändare klickar eller använder Tab-tangenten för att avsluta ett fält.

  När händelsen calculate används för att utföra beräkningar eller skript bör du vara medveten om följande potentiella problem:

• Beräkningar och skript för händelsen calculate får inte ändra formulärets struktur, bara formulärets fälts- och datavärden.

• Innehåll som infogas av händelsen calculate måste överensstämma med tillhörande valideringar för objektet. Annars kan valideringsfel inträffa.

• Beräkningar och skript får inte inkludera en obegränsad slinga, eftersom detta gör att formuläret hela tiden uppdaterar värdet. Ett skript som t ex stegvis ändrar värdet för ett fält som del av ett slinguttryck, som en while- eller for- slinga, skulle kunna skapa en obegränsad slinga.

• Det sista uttrycket som utvärderas i händelsen calculate används för att fylla i värdet för det aktuella formulärobjektet. Om skriptet för händelsen calculate till exempel först anger värdet för det aktuella fältet till 500 och sedan anger värdet för ett annat fält till 1000, visar båda fälten värdet 1000 vid körning. Som en följd av detta är du tvungen att begränsa skripten som du lägger till i händelsen calculate till de som rör inställningen av värdet för det aktuella fältet.

Typ

Processhändelse

Stöd

Version

XFA 2.1

Exempel

Använd händelsen calculate när du vill uppdatera numeriska värden i fält eftersom händelsen startar direkt före de flesta övriga händelser. Om du t ex har ett inköpsorderformulär, kan du använda händelsen calculate för ett fält för att räkna ut momsen baserat på orderkostnaden. Beräkningen startar varje gång värden i formulärfälten ändras, vilket gör att momsvärdet alltid kommer att vara korrekt.

Eftersom händelsen calculate kan starta många gånger, måste du däremot se till att beräkningen eller skriptet som du lägger in i händelsen inte gör att datavärden ändras stegvis i onödan. Om din momsberäkning t ex adderar momsvärdet och den totala kostnaden varje gång händelsen calculate startar, kommer den slutliga totala kostnaden i formuläret att bli för stor.

Ett detaljerat exempel på hur du använder händelsen calculate finns i Beräkna fältsummor.