|
Het scriptobject is een object waarin u JavaScript-functies en waarden afzonderlijk van een eventueel specifiek formulierobject kunt opslaan. U gebruikt scriptobjecten bijvoorbeeld voor het maken van eigen functies en methoden die u wilt gebruiken als onderdeel van JavaScript-scripts op diverse locaties in uw formulier. Met deze methode vermindert u het aantal scripts dat vereist is om herhaalde bewerkingen uit te voeren.
Het scriptobject biedt alleen ondersteuning voor scripts die in JavaScript zijn geschreven, maar er zijn geen beperkingen op de locatie waar de scripts kunnen worden uitgevoerd, zolang de scripttaal voor de gebeurtenis waardoor het scriptobject wordt aangeroepen, op JavaScript is ingesteld.
Zowel Acrobat als Forms verwerken scripts van een scriptobject op dezelfde manier, maar ze zijn ook verschillend.
Alleen scripts die worden uitgevoerd op de client, kunnen gebruik maken van scriptobjecten die zijn ingesteld om op de client te worden uitgevoerd, en andersom.
Een scriptobject makenHet maken van een nieuw scriptobject verloopt in twee fasen. In de eerste fase wordt het object zelf toegevoegd aan het formulierontwerp en in de tweede fase wordt het eigenlijke script geschreven dat u in het scriptobject wilt opslaan.
Maak een nieuw formulier of open een bestaand formulier.
Klik in het palet Hiërarchie met de rechtermuisknop op een object op het niveau van het formulier of op een object op het niveau van een subformulier en kies Scriptobject invoegen.
Afbeelding groot weergeven A. Object op formulierniveau B. Object op subformulierniveau C. Scriptobject op subformulierniveau D. Scriptobject op formulierniveau (Optioneel) Klik met de rechtermuisknop op het scriptobject en kies Naam van object wijzigen.
Een script toevoegen aan een scriptobjectNadat u een scriptobject aan het formulier hebt toegevoegd, kunt u in de Scripteditor scripts toevoegen.
Selecteer het scriptobject in het palet Hiërarchie.
In de Scripteditor wordt de waarde van een scriptobject weergegeven in de lijst Tonen en wordt de waarde van een JavaScript-script weergegeven in de lijst Taal. Deze waarden kunt u niet wijzigen.
Typ het script in het veld Scriptbron.
Klik op het tabblad Voorbeeld-PDF om het formulier te testen.
VoorbeeldMaak bijvoorbeeld een scriptobject met de naam feedback, dat de volgende functie bevat:
function emptyCheck(oField) {
if ((oField.rawValue == null) || (oField.rawValue == "")) {
xfa.host.messageBox("You must input a value for this field.", "Error Message", 3);
}
}
Verwijzen naar JavaScript-functies die in een scriptobject zijn opgeslagenNadat u scripts aan een scriptobject hebt toegevoegd, kunt u naar het scriptobject verwijzen vanuit een willekeurige gebeurtenis die JavaScript-scripts ondersteunt.
Selecteer een object in het formulier en selecteer een gebeurtenis in de lijst Tonen.
Maak een verwijzing naar het scriptobject en naar de functies binnen het scriptobject. In de volgende algemene syntaxis wordt aangenomen dat het object waarin u verwijst naar het scriptobject, zich op hetzelfde niveau bevindt als het scriptobject in de formulierhiërarchie of dat het scriptobject op het hoogste niveau van de formulierhiërarchie bestaat.
script_object.function_name(parameter1, ...);
Pas het nieuwe script toe op het formulierobject en test het door een voorbeeldweergave van het formulier te bekijken via het tabblad Voorbeeld-PDF.
Net als bij het verwijzen naar andere objecten in een formulier, moet u een geldige syntaxis opgeven wanneer u verwijst naar het scriptobject. U moet hierbij ook opgeven op welke locatie binnen de formulierhiërarchie het scriptobject bestaat. Zie Verwijzen naar eigenschappen en waarden van objecten voor meer informatie over het verwijzen naar objecten bij het maken van scripts.
VoorbeeldIn het voorbeeld met het scriptobject uit Een script toevoegen aan een scriptobject plaatst u bijvoorbeeld het volgende JavaScript-script op de gebeurtenis exit voor een tekstveld. Test het formulier met het tabblad Voorbeeld-PDF.
|
|
|
