validate (gebeurtenis)

Beschrijving

Deze gebeurtenis wordt gestart wanneer het formulierontwerp en de gegevens worden samengevoegd om een formulier te vormen en wanneer de focus van een veld verdwijnt, bijvoorbeeld wanneer een gebruiker klikt of de Tab-toets gebruikt om een veld te verlaten. Deze gebeurtenis wordt telkens opnieuw gestart wanneer de waarde van een veld wordt gewijzigd. Berekeningen en scripts die op de validate-gebeurtenis worden geplaatst, bevatten een methode om validaties uit te voeren die specifieker zijn dan de validaties die beschikbaar zijn via het tabblad Waarde van het palet Object.

Berekeningen en scripts op de validate-gebeurtenis moeten true of false retourneren (uitgedrukt in een notatie die geschikt is voor de scipttaal), wat correspondeert met een validatie die is geslaagd of mislukt en mogen geen invloed hebben op de algehele formulierstructuur van formulierwaarden. Daarnaast mogen berekeningen en scripts geen signalen geven aan gebruikers, omdat het mogelijk is dat gebruikers het formulier niet in een clienttoepassing als Acrobat gebruiken.

Opmerking: Aangezien er validaties worden uitgevoerd op de inhoud van het formulier, kunt u geen berekeningen en scripts gebruiken om de opmaak te controleren van de presentatie die het gevolg is van veldpatronen.

Type

Procesgebeurtenis

Ondersteuning

Clienttoepassing

Beschikbaarheid

Acrobat en Adobe Reader

ja

HTML-browser

ja

Versie

XFA 2.1

Voorbeeld

U kunt deze gebeurtenis gebruiken om objectwaarden te controleren, met name in situaties waarin objectgegevens aan bepaalde regels moeten voldoen. U kunt bijvoorbeeld een script plaatsen op de validate-gebeurtenis om te controleren of het veld voor de totale kosten van een inkooporder geen negatieve waarde bevat.

Zie Een veld instellen als vereist tijdens uitvoeren voor een gedetailleerd voorbeeld van het gebruik van de gebeurtenis validate.