Upload
phamtruc
View
220
Download
0
Embed Size (px)
Citation preview
Guide de référence des scripts de Designer
AEM 6.2 Forms
Informations juridiquesPour consulter les informations juridiques, voir https://helpx.adobe.com/fr/legal/legal-notices.html.
Dernière mise à jour le 2/6/18
Table des matières
A propos du guide de référence des scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Sous-formulaires et conteneurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Mappage de version vers l’architecture de formulaires XML (XFA) . . . . . . . . . . . . . . . 2
Hiérarchie des classes de modèles d’objets de formulaires XML . . . . . . . . . . . . . . . . . . 3object, classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3list, classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4treeList, classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5tree, classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5node class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7container, classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9content, classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10model, classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11textNode, classe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Objets de script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13arc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14assist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15barcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16bind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19bindItems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20bookend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21boolean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23break (désapprouvé) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24breakAfter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
i
breakBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29calculate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30caption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32certificates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33checkButton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34choiceList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36comb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39connectionSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40connectString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41contentArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42corner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43dataGroup (désapprouvé) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44dataModel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45dataValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45dataWindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48dateTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49dateTimeEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50decimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51defaultUi (désapprouvé) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53desc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54digestMethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55digestMethods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56draw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57dSigData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59effectiveInputPolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61effectiveOutputPolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63encodings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64encrypt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66eventPseudoModel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67exclGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69exData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72execute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73exObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74extras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76fill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
ii
filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82float . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88hostPseudoModel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89hyphenation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93imageEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95instanceManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96integer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97issuers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99keep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100keyUsage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101layoutPseudoModel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105linear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106manifest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108margin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109mdp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110medium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112numericEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113occur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114oid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115oids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117overflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118packet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119pageArea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120pageSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121para . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124passwordEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126picture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127proto (désapprouvé) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128radial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129reason . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130reasons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
iii
recordSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132rectangle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134ref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135rootElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137select . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138setProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140signatureProperties (désapprouvé) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141signaturePseudoModel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142signData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143signing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144soapAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145soapAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146solid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148sourceSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150speak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151stipple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152subform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153subformSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156subjectDN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157subjectDNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158submit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162textEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164timeStamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165toolTip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166traversal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167traverse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168ui . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170uri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172validate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175wsdlAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176wsdlConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177xfa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178xmlConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179xsdConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
iv
Propriétés de script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181#text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181{default} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183accessKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187addRevocationInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191after (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192afterTarget (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193aliasNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195allowMacro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196allowNeutral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198allowRichText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199anchorType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200appType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203aspect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204baselineShift . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206before (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207beforeTarget (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209bind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211blank (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212blankOrNotBlank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213bofAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215bookendLeader (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216bookendTrailer (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217borderColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218borderWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219bottomInset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220break . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221calculationsEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222cancelAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224cap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227charEncoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228checksum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230circular . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232classAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234classId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235classIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235className . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236codeBase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
v
codeType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238colSpan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239columnWidths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240commandType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242commitKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243commitOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246contains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248contentType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249context (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251credentialServerPolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253crlSign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254cSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255currentPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256currentRecordNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257currentValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258cursorLocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258cursorType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261dataColumnCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262dataDescription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264dataEncipherment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265dataLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266dataNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267dataPrep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268dataRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269db . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271decipherOnly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272delayedOpen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273delimiter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274digitalSignature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276disableAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277duplexImposition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278editValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279embedPDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279encipherOnly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281endChar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282eofAction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283errorCorrectionLevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284errorText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285excludeAllCaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286excludeInitialCap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
vi
executeType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288fillColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289fontColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290fontHorizontalScale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291fontVerticalScale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293formatMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295formattedValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296formatTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297fracDigits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299from . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301fullText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303hAlign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304hand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306highlight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307href . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309hScrollPolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310hyphenate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312imagingBBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314initial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315initialNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317instanceIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318intact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319inverted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320isContainer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322isDefined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323isNull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326kerningMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327keyAgreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329keyCertSign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330keyDown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331keyEncipherment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332labelRef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333ladderCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335leadDigits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338leader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339leftInset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
vii
letterSpacing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342lineHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343lineThrough . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345lineThroughPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348lockType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349long . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351mandatory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352mandatoryMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353marginLeft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354marginRight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356match . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360maxChars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361maxH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362maxLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363maxW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364mergeMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366minH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368minW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370modifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371moduleHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372moduleWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374multiLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376newContentType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378newText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382nonRepudiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383ns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384nullTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385numbered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387numberOfCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388numPages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390oddOrEven . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391oneOfChild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392open . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
viii
overflowLeader (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399overflowTarget (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400overflowTrailer (désapprouvée) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401override . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402pagePosition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405parent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407parentSubform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408passwordChar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410placement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413posture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414presence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416preserve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418prevContentType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419previous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420prevText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422printCheckDigit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424pushCharacterCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426radius . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427radixOffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429rawValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430ready . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432recordsAfter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434recordsBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435reenter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436ref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438relation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439relevant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440remainCharacterCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442reserve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443restoreState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444rightInset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447rotate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449rowColumnRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450runAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452savedValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454scriptTest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456selectedIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458selEnd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
ix
selStart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461shape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461shift . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463short . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464signatureType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466slope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467soapFaultCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469soapFaultString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470somExpression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470spaceAbove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471spaceBelow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473startAngle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474startChar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475startNew . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476stateless . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477stock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478stroke . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479sweepAngle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482tabDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483tabStops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487targetType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489textEncoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490textEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495textIndent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496textLocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497thickness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499this . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502timeStamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504topInset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505trailer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506transferEncoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507transient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508truncate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510typeface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517underline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518underlinePeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520upsMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522urlPolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
x
usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525usehref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526uuid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528validationMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529validationsEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530vAlign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532valueRef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534variation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536vScrollPolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539weight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540wideNarrowRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542wordCharacterCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543wordSpacingMaximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544wordSpacingMinimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545wordSpacingOptimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547xdpContent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
Méthodes de script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552Méthodes de script pour Acrobat et Adobe Reader . . . . . . . . . . . . . . . . . . . . . . . 552Méthodes de script pour les macros Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . 675
Comprendre le modèle d’objet de formulaire XML . . . . . . . . . . . . . . . . . . . . . . . 684DOM du modèle d’objet de formulaire XML . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
Exemples de JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691Référence aux objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691
xi
A propos du guide de référence des scripts 1
1. A propos du guide de référence des scripts
1
Le modèle d’objet de formulaire XML® Adobe, fondé sur l’architecture de formulaires XML d’Adobe, représente la technologie sous-jacente derrière la solution de formulaire XML d’Adobe et incorpore les concepts architecturaux XML comme le modèle d’objet de document (DOM). Grâce à cette technologie, les développeurs de formulaires peuvent créer des applications de formulaires complexes et flexibles pour une utilisation avec le client ou le serveur.
Designer permet aux développeurs de formulaires de générer des formulaires intelligents en n’utilisant que les options fournies dans l’interface graphique Designer.
L’exécution de scripts par rapport au modèle d’objet de formulaire XML permet aux développeurs de formulaires de mieux contrôler tous les aspects du formulaire et d’améliorer ses fonctionnalités au-delà de ce qui est disponible via l’interface Designer. Par exemple, vous avez la possibilité d’utiliser un calcul simple pour assurer la mise à jour automatique du total d’un bon de commande ou bien des scripts complexes pour adapter la présentation d’un formulaire à la langue et au pays de l’utilisateur.
Les scripts sont pris en charge en deux langages : FormCalc, langage de calcul créé par Adobe Systems Incorporated, et JavaScript, langage de scripts puissant et populaire.
Chaque hôte (par exemple, Adobe® Acrobat et Adobe® Reader) est chargé de mettre en œuvre les méthodes disponibles. Certaines méthodes, comme la méthode beep, ne présentent aucun intérêt sur un serveur. Le serveur n’implémente pas ces méthodes et peut même produire un message d’erreur si l’utilisateur essaie d’appeler la méthode.
Pour plus d’informations sur les principes de base de la création de scripts, voir Concepts de base des scripts.
REMARQUE : Ce document utilise les termes d’Adobe Experience Manager Forms, d’AEM Forms, d’AEM Forms on JEE et de LiveCycle de manière interchangeable.
1.1. Sous-formulaires et conteneurs
Dans Designer, les formulaires sont des documents créés à partir d’une hiérarchie de blocs de constructions éventuellement extensibles connus sous le nom de sous-formulaires. Chaque sous-formulaire contrôle une partie de l’ensemble de la structure, présentation et comportement du formulaire. Les sous-formulaires individuels encadrent une combinaison d’objets qui produisent des zones remplissables (champs) et des zones non remplissables (dessins). Les sous-formulaires peuvent aussi contenir d’autres sous-formulaires, et chacun d’entre eux peut posséder des propriétés déterminant comment et quand le sous-formulaire est instancié dans un formulaire construit.
A propos du guide de référence des scripts
Un concept de conteneur se trouve au sein de chaque formulaire. Un container est un objet contenant des données ou des valeurs. Les conteneurs simples sont ceux qui ne peuvent pas contenir d’autres conteneurs ou objets, notamment des champs (texte, numériques, touches) et des objets dessinés (texte, cercle, ligne). Tous les conteneurs capables de contenir d’autres conteneurs, ainsi que des objets qui ne sont pas des conteneurs sont considérés comme des conteneurs complexes. Les sous-formulaires sont un exemple de conteneur complexe.
1.2. Mappage de version vers l’architecture de formulaires XML (XFA)
Chaque version de Designer inclut une version spécifique de l’architecture de formulaires XML (XFA). XFA est une technologie sur laquelle repose la solution de formulaires XML d’Adobe.
La version XFA dans laquelle une propriété ou une méthode de script a été ajoutée est incluse dans la description de chaque propriété et méthode.
Version XFA Version de Designer
3.6 A usage interne
3.5 10.0
3.3 A usage interne
3.2 9.0.1
3.1 9.0
3.0 8.2.1
2.9 A usage interne
2.8 8.2
2.7 A usage interne
2.6 8.1
2.5 8.0
2.4 7.1
2.3 A usage interne
2.2 7.0
2.1 6.0
2
Hiérarchie des classes de modèles d’objets de formulaires XML 2
2. Hiérarchie des classes de modèles d’objets de formulaires XML
3
Le modèle d’objet de formulaire XML se compose de modèles contenant chacun un jeu d’objets. Chaque objet est dérivé de l’un des jeux de classes qui définissent les propriétés et méthodes communes. Un objet hérite de ces propriétés et méthodes communes, mais peut aussi ajouter des propriétés et des méthodes uniques à cet objet, ou relatives à d’autres objets dérivés de la même classe.
A l’instar des structures de classes traditionnelles, chaque classe hérite des propriétés et méthodes de sa classe parent. Les objets à leur tour héritent de la classe parent dont ils sont issus.
Chaque modèle utilise une hiérarchie d’objets. Les objets n’héritent pas des propriétés et méthodes d’autres objets, mais héritent directement de la hiérarchie de classes. La hiérarchie des objets dans un modèle représente la structure XML de ce modèle.
2.1. object, classe
La classe object constitue la classe de base dont sont issus, directement ou indirectement, les autres classes, objets et modèles.
2.1.1. Hiérarchie de classes
Classe parent Classe en cours Objets dérivés de cette classe
Aucun object dataWindoweventPseudoModelhostPseudoModellayoutPseudoModelsignaturePseudoModel
2.1.2. Propriétés
Nom Description Type Accès
className Spécifie le nom de la classe de cet objet. Chaîne Get
Hiérarchie des classes de modèles d’objets de formulaires XML
2.1.3. Méthodes
Aucun
2.2. list, classe
La classe liste représente une liste de nœuds.
2.2.1. Hiérarchie de classes
Classe parent Classe en cours Objets dérivés de cette classe
object, classe liste Aucun
2.2.2. Propriétés
Nom Description Type Accès
length Indique le nombre d’objets dans la liste. Entier Lecture
2.2.3. Méthodes
Nom Description Renvoie
append Ajoute un nœud à la fin de la liste de nœuds. Vide
insert Insère un nœud avant un nœud spécifique dans la liste des nœuds. Vide
item Décrit un index à base zéro dans la collection. Objet
remove Supprime un nœud de la liste. Vide
4
Hiérarchie des classes de modèles d’objets de formulaires XML 2
2.3. treeList, classe
5
La classe treeList représente une liste de nœuds d’arborescence.
2.3.1. Hiérarchie de classes
Classe parent Classe en cours Objets dérivés de cette classe
liste treeList Aucun
2.3.2. Propriétés
Aucun
2.3.3. Méthodes
Nom Description Renvoie
namedItem Récupère le premier enfant du nœud portant le nom donné. Objet
2.4. tree, classe
La classe tree représente la structure dont est issue la classe node class.
2.4.1. Hiérarchie de classes
Classe parent Classe en cours Objets dérivés de cette classe
object, classe tree Aucun
Hiérarchie des classes de modèles d’objets de formulaires XML
2.4.2. Propriétés
Nom Description Type Accès
all Renvoie une collection de nœuds de même nom et compris dans la plage indiquée.
Objet Lecture
classAll Renvoie une collection de nœuds de même classe et compris dans la plage indiquée.
Objet Lecture
classIndex Renvoie la position de l’objet dans sa collection d’objets de même classe et compris dans la plage indiquée.
Entier Lecture
index Renvoie la position du nœud dans sa collection de nœuds de même nom et compris dans la plage indiquée.
Entier Lecture
name Identificateur qui permet de désigner un objet ou un événement dans les expressions de script.
Chaîne Lecture/écriture
nodes Renvoie une liste de tous les objets enfants de l’objet actuel. Objet Lecture
parent Renvoie l’objet parent de l’objet en cours. Objet Lecture
somExpression Récupère l’expression de syntaxe de référence correspondant à ce nœud. Chaîne Lecture
2.4.3. Méthodes
Nom Description Renvoie
resolveNode Evalue l’expression de syntaxe de référence spécifiée, en commençant par l’objet modèle de l’objet de formulaire XML actif et renvoie la valeur de l’objet spécifié dans l’expression de syntaxe de référence.
Objet
resolveNodes Evalue l’expression de syntaxe de référence spécifiée, en commençant par l’objet modèle de l’objet de formulaire XML actif et renvoie la valeur de l’objet ou des objets spécifiés dans l’expression de syntaxe de référence.
Objet
6
Hiérarchie des classes de modèles d’objets de formulaires XML 2
2.5. node class
7
La classe node représente le type de données primaires pour les objets de modèle d’objet de formulaire XML.
2.5.1. Hiérarchie de classes
Classe parent
Classe en cours
Objets dérivés de cette classe
tree, classe
node arcassistbarcodebindbindItemsbookendborderbreak (désapprouvé)breakAfterbreakBeforebuttoncalculatecaptioncertificatescheckButtonchoiceListcolorcombcommandconnectcornerdataGroup (désapprouvé)dataValuedateTime
dateTimeEditdefaultUi (désapprouvé)descdigestMethoddigestMethodsdSigDataedgeencodingencodingsencrypteventexclGroupexecuteexObjectextrasfillfilterfontformatimageimageEditinstanceManagerissuersitems
keepkeyUsagelinelinearmanifestmapmarginmdpmediummessagenumericEditoccuroidsoverflowpacketparapasswordEditpatternpictureproto (désapprouvé)queryradialreasons
recordSetrectanglescriptsetPropertysignaturesignDatasigningsolidsourcestipplesubjectDNsubjectDNssubmittextEdittimeStamptraversaltraverseuivalidatevaluewsdlConnectionxmlConnectionxsdConnection
Hiérarchie des classes de modèles d’objets de formulaires XML
2.5.2. Propriétés
Nom Description Type Accès
id Spécifie un type d’ID XML générique défini par l’utilisateur. Chaîne Lecture/écriture
isContainer Indique si l’objet est un objet conteneur. Booléen Lecture
isNull Indique si la valeur de données actuelle est la valeur nulle. Booléen Lecture
model Indique le modèle de l’objet actuel. Objet Lecture
ns Renvoie l’espace de noms correspondant à l’objet. Chaîne Lecture
oneOfChild Récupère ou définit l’objet enfant dans le cas où un objet parent peut disposer uniquement d’un objet enfant particulier.
Objet Lecture/écriture
2.5.3. Méthodes
Nom Description Renvoie
applyXSL Applique une transformation XSL à une représentation XML du nœud actif. Vous pouvez également appeler saveXML et transformer le résultat à l’aide du document XSL spécifié.
Chaîne
assignNode Evalue l’expression de syntaxe de référence dans le contexte actif et définit la valeur du nœud détecté. Si le nœud n’existe pas, il peut être créé.
Objet
clone Effectue la copie d’un objet. Objet
getAttribute Récupère une valeur de propriété spécifiée. Chaîne
getElement Renvoie un objet enfant spécifié. Objet
isPropertySpecified Vérifie si une propriété spécifique a été définie pour ce nœud. Booléen
loadXML Charge et ajoute un document XML spécifié à l’objet actif. Vide
saveFilteredXML Enregistre le nœud actif dans une chaîne, mais inclut uniquement un jeu partiel des nœuds enfant.
Chaîne
saveXML Enregistre la structure XML de la classe node actuelle sur pagevii dans une chaîne.
Chaîne
setAttribute Définit la valeur d’une propriété spécifiée. Vide
setElement Définit un objet spécifié sur l’objet actif. Vide
8
Hiérarchie des classes de modèles d’objets de formulaires XML 2
2.6. container, classe
9
La classe container fournit des objets de conteneur aux modèles de formulaire.
2.6.1. Hiérarchie de classes
Classe parent Classe en cours Objets dérivés de cette classe
node class container areacontentAreadrawfieldpageAreapageSetsubformsubformSetvariable
2.6.2. Propriétés
Aucun
2.6.3. Méthodes
Nom Description Renvoie
getDelta Permet d’obtenir un objet de script delta pour une propriété spécifique. Objet
getDeltas Recherche de façon récursive tous les objets de script delta pour cet objet de conteneur et tous ses descendants.
Objet
Hiérarchie des classes de modèles d’objets de formulaires XML
2.7. content, classe
La classe content fournit des objets de contenu aux modèles de formulaire et aux modèles de conception. Les conceptions de formulaires et les formulaires terminés sont composés d’objets visuels représentant du contenu, tels que des images et du texte.
2.7.1. Hiérarchie de classes
Classe parent Classe en cours Objets dérivés de cette classe
node class content booleandatedateTimedecimalexDatafloatintegertexttime
2.7.2. Propriétés
Aucun
2.7.3. Méthodes
Aucun
10
Hiérarchie des classes de modèles d’objets de formulaires XML 2
2.8. model, classe
11
La classe model constitue la classe de base pour les objets racine de chaque modèle.
2.8.1. Hiérarchie de classes
Classe parent Classe en cours Objets dérivés de cette classe
node class model connectionSetdataModelformtemplatesourceSetxfa
2.8.2. Propriétés
Nom Description Type Accès
aliasNode Indique l’objet représenté par le pseudonyme pour ce modèle. Objet Lecture/écriture
context (désapprouvée)
Spécifie l’objet actif, qui est l’objet de début pour les méthodes "resolveNode" sur pagecccli et "resolveNodes" sur pageccclii.
Objet Lecture/écriture
2.8.3. Méthodes
Nom Description Renvoie
clearErrorList Supprime tous les éléments du journal d’erreurs actuel. Vide
createNode Crée un nouveau nœud en fonction d’un nom de classe correct. Objet
isCompatibleNS Détermine si un espace de noms spécifié fonctionne, c’est-à-dire est compatible avec l’espace de noms de ce modèle. Détermine si les deux espaces de noms sont équivalents, même si les chaînes qui les représentent ne le sont pas.
Booléen
Hiérarchie des classes de modèles d’objets de formulaires XML
2.9. textNode, classe
La classe textNode représente des objets qui stockent des données textuelles directement au lieu d’utiliser l’objet #text dérivé de la classe node class.
2.9.1. Hiérarchie de classes
Classe parent Classe en cours Objets dérivés de cette classe
node class textNode certificateconnectStringdeletehandlerinsertoidoperationpasswordreasonref
rootElementselectsoapActionsoapAddressspeaktoolTipupdateuriuserwsdlAddress
2.9.2. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
2.9.3. Méthodes
Aucun
12
Objets de script 3
3. Objets de script
13
Vous y trouverez une brève description des propriétés et des méthodes associées à chaque objet pris en charge dans cet environnement de scripts, et des liens renvoyant aux descriptions détaillées des propriétés et méthodes.
A chaque objet correspond un tableau représentant la hiérarchie des objets parent et enfant se rapportant à l’objet actuel. Cette hiérarchie parent/enfant est un moyen pratique de déterminer la syntaxe de script qu’il convient d’utiliser pour faire référence à un objet en particulier.
3.1. arc
L’objet arc décrit un arc ou une ellipse.
3.1.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire edgefill
3.1.2. Classe parent
node class catégorie
3.1.3. Propriétés
Nom Description Type Accès
circular Permet de convertir un arc en cercle. Chaîne Lecture/écriture
hand Décrit la justification d’une ligne ou d’un bord. Chaîne Lecture/écriture
startAngle Indique l’angle à l’origine d’un arc. Chaîne Lecture/écriture
Objets de script
sweepAngle Indique la longueur d’un arc, exprimée comme un angle. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Nom Description Type Accès
3.1.4. Méthodes
Aucun
3.2. area
L’objet area représente le regroupement d’autres objets de conteneur sur un formulaire.
3.2.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire descextras
3.2.2. Classe parent
container, classe
14
Objets de script 3
3.2.3. Propriétés
15
Nom Description Type Accès
colSpan Spécifie le nombre de colonnes étendues par cet objet lorsqu’il est incorporé dans un sous-formulaire doté d’un type de disposition des rangées particulier.
Chaîne Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
x Indique la coordonnée X du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
y Indique la coordonnée Y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
3.2.4. Méthodes
Aucun
3.3. assist
L’objet assist fournit des informations supplémentaires sur un conteneur pour les utilisateurs des applications de formulaires interactifs.
Il permet de spécifier l’objet toolTip et le comportement d’une invite parlée.
3.3.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire speaktoolTip
Objets de script
3.3.2. Classe parent
node class catégorie
3.3.3. Propriétés
Nom Description Type Accès
role Indique le rôle joué par le conteneur parent. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.3.4. Méthodes
Aucun
3.4. barcode
L’objet barcode fournit les informations nécessaires à l’affichage d’un code à barres. Ces informations comprennent le type de code à barres et un ensemble d’options différentes selon les types de codes à barres.
Designer peut prendre en charge deux types de codes à barres : matériel et logiciel. Toutefois, une application XFA n’est pas nécessaire pour prendre en charge un ensemble de codes à barres particulier. Les codes à barres matériels sont affichés pour des imprimantes particulières. L’ensemble de codes à barres pris en charge peut être différent selon le périphérique d’affichage, car certaines impri-mantes sont équipées d’un système intégré de prise en charge de codes à barres particuliers. Les codes à barres logiciels sont dessinés contour par contour par l’application XFA elle-même. A l’écran, indéchiffrable par les lecteurs de codes à barres, une application XFA peut remplacer un code à barres précis par une balise d’emplacement.
Pour chaque type de code à barres, il y a généralement deux spécifications, une pour le code à barres lui-même, et une pour sa position par rapport à la page physique et les caractères imprimés environ-nants. L’auteur de la conception de formulaire doit s’assurer que le code à barres est correctement placé sur la page. L’application XFA est responsable de la génération correcte du code à barres à l’aide des données utilisateur. Les données utilisateur doivent être compatibles avec le code à barres, c’est-à-dire doivent se conformer au jeu et à la longueur de caractères autorisés.
16
Objets de script 3
3.4.1. Hiérarchie des objets
17
Modèle Objets enfant
Modèle de formulaire extras
3.4.2. Classe parent
node class catégorie
3.4.3. Propriétés
Nom Description Type Accès
charEncoding Spécifie le codage de caractères de la valeur codée dans un code à barres.
Chaîne Lecture/écriture
checksum Indique un algorithme de la somme de contrôle à insérer dans un code à barres.
Chaîne Lecture/écriture
dataColumnCount
Spécifie un nombre facultatif de colonnes de données à coder pour les codes à barres pris en charge. Cette propriété s’applique uniquement aux codes à barres bidimensionnels (2D).
Chaîne Lecture/écriture
dataLength Indique le nombre maximal de caractères de cette instance du code à barres. Cette propriété s’applique uniquement aux codes à barres unidimensionnels.
Chaîne Lecture/écriture
dataPrep Définit le prétraitement appliqué aux données consignées dans le code à barres.
Chaîne Lecture/écriture
dataRowCount Spécifie un nombre facultatif de rangées de données à coder pour les codes à barres pris en charge. Cette propriété s’applique uniquement aux codes à barres bidimensionnels (2D).
Chaîne Lecture/écriture
endChar Indique un caractère de commande de fin facultatif à ajouter aux données du code à barres.
Chaîne Lecture/écriture
errorCorrectionLevel
Indique un niveau de correction d’erreur facultatif à appliquer aux codes à barres pris en charge. Cette propriété s’applique uniquement aux codes à barres bidimensionnels (2D).
Chaîne Lecture/écriture
Objets de script
moduleHeight Détermine la hauteur d’une série de barres utilisées pour coder un caractère de texte fourni.
Chaîne Lecture/écriture
moduleWidth Spécifie différents aspects d’un code à barres en fonction de la classe de codes à barres utilisée.
Chaîne Lecture/écriture
printCheckDigit Spécifie si les chiffres de contrôle doivent être imprimés dans le texte affichable.
Chaîne Lecture/écriture
rowColumnRatio
Un rapport facultatif rangées/colonnes pour les codes à barres 2D pris en charge.
Chaîne Lecture/écriture
startChar Indique le caractère de commande de départ facultatif à ajouter au début des données du code à barres.
Chaîne Lecture/écriture
textLocation Indique l’emplacement de tout texte associé au code à barres. Chaîne Lecture/écriture
truncate Tronque le bord droit du code à barres pour les formats pris en charge. Chaîne Lecture/écriture
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
upsMode Représente le mode dans un code à barres UPS Maxicode. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
wideNarrowRatio
Spécifie un rapport barre large/barre étroite dans les codes à barres pris en charge.
Chaîne Lecture/écriture
Nom Description Type Accès
3.4.4. Méthodes
Aucun
18
Objets de script 3
3.5. bind
19
L’objet bind contrôle le comportement de son objet parent au cours des opérations de fusion.
3.5.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaireModèle sourceSet
picture
3.5.2. Classe parent
node class catégorie
3.5.3. Propriétés
Nom Description Type Accès
contentType Spécifie le type de contenu présent dans le document référencé, à savoir MIME.
Chaîne Lecture/écriture
match Contrôle le rôle de l’objet encadré lors d’une opération de liaison de données (fusion).
Chaîne Lecture/écriture
ref Spécifie une expression de syntaxe de référence définissant le nœud dans le modèle de données auquel le conteneur englobant est associé.
Chaîne Lecture/écriture
transferEncoding Indique le codage du contenu binaire dans le document référencé. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.5.4. Méthodes
Aucun
Objets de script
3.6. bindItems
L’objet bindItems identifie un ensemble de nœuds de données à lier.
L’application de l’objet bindItems est une opération de liaison. Les liens entre les éléments de liste et les données référencées sont actifs. Toute modification apportée aux données provoque la mise à jour immédiate des éléments de la liste.
3.6.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire ref
3.6.2. Classe parent
node class catégorie
3.6.3. Propriétés
Nom Description Type Accès
connection Spécifie le nom du contrôle de connexion associé dans l’ensemble de connexions.
Chaîne Lecture/écriture
labelRef Résout une valeur de données pour chaque nœud de données dans le jeu identifié par l’objet ref.
Chaîne Lecture/écriture
valueRef Résout une valeur de données pour chaque nœud de données dans le jeu identifié par l’objet ref.
Chaîne Lecture/écriture
3.6.4. Méthodes
Aucun
20
Objets de script 3
3.7. bookend
21
L’objet bookend stocke des propriétés qui identifient des sous-formulaires facultatifs encadrant le contenu du sous-formulaire parent.
La propriété leader identifie un objet subform ou subformSet facultatif disposé en premier, avant le contenu du conteneur parent. La propriété trailer identifie un objet subform ou subformSet disposé en dernier, après le contenu du conteneur parent. Ainsi, ces propriétés encadrent le contenu du conteneur parent et ce, quel que soit le nombre d’objets contentArea ou pageArea que le conteneur parent couvre.
3.7.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.7.2. Classe parent
node class catégorie
3.7.3. Propriétés
Nom Description Type Accès
leader Indique l’objet subform ou subformSet devant être placé en haut d’une zone de contenu ou d’une zone de page.
Chaîne Lecture/écriture
trailer Indique l’objet subform ou subformSet devant être placé en bas d’une zone de contenu ou d’une zone de page.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.7.4. Méthodes
Aucun
Objets de script
3.8. boolean
La propriété boolean décrit une unité de contenu unique représentant une valeur logique booléenne.
3.8.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaireModèle sourceSet
Aucun
3.8.2. Classe parent
content, classe catégorie
3.8.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Booléen Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Booléen Lecture/écriture
3.8.4. Méthodes
Aucun
22
Objets de script 3
3.9. border
23
L’objet border décrit la bordure entourant un objet.
3.9.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire corneredgeextrasfillmargin
3.9.2. Classe parent
node class catégorie
3.9.3. Propriétés
Nom Description Type Accès
break Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu après la génération d’un objet.
Chaîne Lecture/écriture
hand Décrit la justification d’une ligne ou d’un bord. Chaîne Lecture/écriture
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.9.4. Méthodes
Aucun
3.10. break (désapprouvé)
L’objet break décrit les contraintes liées au déplacement vers une nouvelle page ou zone de contenu avant ou après la génération d’un objet.
3.10.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.10.2. Classe parent
node class catégorie
3.10.3. Propriétés
Nom Description Type Accès
after (désapprouvée) Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu après la génération du sous-formulaire.A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir breakAfter.
Chaîne Lecture/écriture
afterTarget (désapprouvée) Spécifie la page de destination ou la zone de contenu explicite pour la propriété after (désapprouvée).A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir breakAfter.target.
Chaîne Lecture/écriture
before (désapprouvée) Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu avant la génération du sous-formulaire.A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir breakBefore.
Chaîne Lecture/écriture
24
Objets de script 3
25
beforeTarget (désapprouvée)
Spécifie la page de destination ou la zone de contenu explicite pour la propriété before (désapprouvée) .A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir breakBefore.target.
Chaîne Lecture/écriture
bookendLeader (désapprouvée)
(bookendLeader) Indique un sous-formulaire à placer dans la zone de contenu ou la page active avant tout autre contenu.
Chaîne Lecture/écriture
bookendTrailer (désapprouvée)
Indique le sous-formulaire à placer dans la zone de contenu ou la page active après tout autre contenu.
Chaîne Lecture/écriture
overflowLeader (désapprouvée)
Indique le sous-formulaire à placer en haut de la zone de contenu ou de la page lorsqu’il est activé suite à un débordement.A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir leader.
Chaîne Lecture/écriture
overflowTarget (désapprouvée)
Indique la zone de contenu explicite qui servira de cible de transition lorsque la zone de contenu ou la page actuelle sera dépassée.
Chaîne Lecture/écriture
overflowTrailer (désapprouvée)
Indique le sous-formulaire à placer au bas de la zone de contenu ou de la page en cas de débordement.A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir trailer
Chaîne Lecture/écriture
startNew Indique s’il est nécessaire de commencer une nouvelle zone de contenu ou une page même lorsque la zone de contenu ou de page actuelle est dotée du nom requis.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Nom Description Type Accès
3.10.4. Méthodes
Aucun
Objets de script
3.11. breakAfter
L’objet breakAfter décrit les contraintes conditionnelles liées au déplacement vers une nouvelle page ou zone de contenu après le placement du conteneur parent. L’objet breakAfter est appelé après la disposition du sous-formulaire parent. Les débuts ou fins sont mis en forme avant et après les sauts imposés par l’objet breakAfter.
Un objet script facultatif associé à l’objet breakAfter détermine s’il est respecté ou pas. Cet objet script est associé à la condition True par défaut, ce qui signifie que les objets breakAfter sans objet script sont toujours appelés.
L’objet breakAfter est fonctionnellement équivalent à la syntaxe désapprouvée de break (désap-prouvée).after (désapprouvée) et afterTarget (désapprouvée).
3.11.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire script
3.11.2. Classe parent
node class catégorie
3.11.3. Propriétés
Nom Description Type Accès
leader Indique l’objet subform ou subformSet devant être placé en haut d’une zone de contenu ou d’une zone de page.
Chaîne Lecture/écriture
startNew Indique s’il est nécessaire de commencer une nouvelle zone de contenu ou une page même lorsque la zone de contenu ou de page actuelle est dotée du nom requis.
Chaîne Lecture/écriture
target Indique l’objet sur lequel l’action se produit. Chaîne Lecture/écriture
targetType Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu avant la disposition du sous-formulaire parent.
Chaîne Lecture/écriture
26
Objets de script 3
27
trailer Indique l’objet subform ou subformSet devant être placé en bas d’une zone de contenu ou d’une zone de page.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Nom Description Type Accès
3.11.4. Méthodes
Aucun
3.12. breakBefore
L’objet breakBefore décrit les contraintes conditionnelles liées au déplacement vers une nouvelle page ou zone de contenu avant le placement du conteneur parent. L’objet breakBefore est appelé avant la disposition du sous-formulaire parent. Les débuts et fins sont mis en forme avant et après les sauts imposés par l’objet breakBefore.
Un objet script facultatif associé à l’objet breakBefore détermine s’il est respecté ou pas. Cet objet script est associé à la condition True par défaut, ce qui signifie que les objets breakBefore sans objet script sont toujours appelés.
L’objet breakBefore est fonctionnellement équivalent à la syntaxe désapprouvée de break (désapprouvée).before (désapprouvée) et beforeTarget (désapprouvée).
3.12.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire script
3.12.2. Classe parent
node class catégorie
Objets de script
3.12.3. Propriétés
Nom Description Type Accès
leader Indique l’objet subform ou subformSet devant être placé en haut d’une zone de contenu ou d’une zone de page.
Chaîne Lecture/écriture
startNew Indique s’il est nécessaire de commencer une nouvelle zone de contenu ou une page même lorsque la zone de contenu ou de page actuelle est dotée du nom requis.
Chaîne Lecture/écriture
target Indique l’objet sur lequel l’action se produit. Chaîne Lecture/écriture
targetType Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu avant la disposition du sous-formulaire parent.
Chaîne Lecture/écriture
trailer Indique l’objet subform ou subformSet devant être placé en bas d’une zone de contenu ou d’une zone de page.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.12.4. Méthodes
Aucun
28
Objets de script 3
3.13. button
29
L’objet button décrit un bouton de commande.
3.13.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.13.2. Classe parent
node class catégorie
3.13.3. Propriétés
Nom Description Type Accès
highlight Indique l’aspect visuel d’un bouton lorsque celui-ci est activé par un utilisateur. Toutes les valeurs prennent en charge deux états (relâché et enfoncé) à l’exception de l’état relâché, qui prend en charge trois états (relâché, enfoncé et effleuré).
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.13.4. Méthodes
Aucun
Objets de script
3.14. calculate
L’objet calculate contrôle le calcul de la valeur d’un champ.
3.14.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extrasmessagescript
3.14.2. Classe parent
node class catégorie
3.14.3. Propriétés
Nom Description Type Accès
override Utilisée avec l’objet calculate, la propriété override indique si le champ autorise les remplacements et désactive ou active les calculs. Lorsqu’elle est utilisée avec l’objet value, la propriété override indique si un remplacement des calculs a eu lieu.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.14.4. Méthodes
Aucun
30
Objets de script 3
3.15. caption
31
L’objet caption décrit un libellé descriptif associé à un objet de conception de formulaire.
3.15.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extrasfontmarginparavalue
3.15.2. Classe parent
node class catégorie
3.15.3. Propriétés
Nom Description Type Accès
placement Indique l’emplacement de la légende. Chaîne Lecture/écriture
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
reserve Mesure indiquant la hauteur ou la largeur d’une légende. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.15.4. Méthodes
Aucun
Objets de script
3.16. certificate
L’objet certificate contient un certificat.
3.16.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.16.2. Classe parent
textNode, classe catégorie
3.16.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.16.4. Méthodes
Aucun
32
Objets de script 3
3.17. certificates
33
L’objet certificates contient un ensemble de filtres de certificat.
3.17.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire issuerskeyUsageoidssigningsubjectDNs
3.17.2. Classe parent
node class catégorie
3.17.3. Propriétés
Nom Description Type Accès
credentialServerPolicy
Indique si la vérification de l’état du certificat est nécessaire lorsqu’une signature numérique est signée. L’état du certificat peut être vérifié à l’aide d’une liste de révocation des certificats ou d’une réponse OCSP (Online Certificate Status Protocol).
Chaîne Lecture/écriture
url Spécifie l’URL pour cet objet. Chaîne Lecture/écriture
urlPolicy Spécifie le type d’URL représenté par l’objet de certificat. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.17.4. Méthodes
Aucun
Objets de script
3.18. checkButton
L’objet checkButton décrit l’aspect visuel d’une case à cocher ou d’un bouton radio dans Designer. Les objets case à cocher et bouton radio sont définis par l’objet field.
REMARQUE : Un groupe d’objets bouton radio est inclus dans un objet exclGroup.
3.18.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire borderextrasmargin
3.18.2. Classe parent
node class catégorie
3.18.3. Propriétés
Nom Description Type Accès
allowNeutral Indique si la case à cocher ou le bouton radio prend en charge un troisième état représentant une valeur neutre.
Chaîne Lecture/écriture
mark Indique la forme à utiliser lors du remplissage d’un objet de case à cocher.
Chaîne Lecture/écriture
shape Indique si le contour de la case à cocher ou du bouton radio est carré ou rond.
Chaîne Lecture/écriture
size Mesure indiquant la taille du contour de la case à cocher ou du bouton radio, soit la hauteur et la largeur s’il s’agit d’une case à cocher, soit le diamètre s’il s’agit d’un bouton radio.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
34
Objets de script 3
3.18.4. Méthodes
35
Aucun
3.19. choiceList
L’objet choiceList décrit l’aspect visuel d’une liste déroulante ou d’une zone de liste dans Designer. Les objets liste déroulante ou zone de liste sont définis par l’objet field.
3.19.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire borderextrasmargin
3.19.2. Classe parent
node class catégorie
3.19.3. Propriétés
Nom Description Type Accès
commitOn Indique lorsque les sélections de l’utilisateur sont transmises au modèle de données.
Chaîne Lecture/écriture
open Détermine le moment où la liste à choix multiples est présentée par les applications interactives.
Chaîne Lecture/écriture
textEntry Détermine si un utilisateur peut saisir une valeur dans une liste déroulante.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.19.4. Méthodes
Aucun
3.20. color
L’objet color décrit une couleur unique sur un formulaire.
3.20.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.20.2. Classe parent
node class catégorie
3.20.3. Propriétés
Nom Description Type Accès
cSpace Spécifie l’espace colorimétrique. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.20.4. Méthodes
Aucun
36
Objets de script 3
3.21. comb
37
L’objet comb décrit un champ combiné, où chaque lettre du champ est séparée par une ligne verticale noire qui s’étend du bord supérieur au bord inférieur du champ. L’objet comb n’est disponible que pour les formulaires de génération de PDF interactifs ou dynamiques. Les formulaires PDF statiques, et tous les autres formats de sortie, ignorent cet objet.
Seuls les champs combinés d’une ligne unique peuvent être créés. Pour afficher les données de champ sous forme de peigne, vous devez définir la valeur de la propriété hand pour l’objet bordure du champ sur right. La propriété maxChars sur l’objet textEdit détermine le nombre de combinaisons à créer.
REMARQUE : Si un objet textEdit est un champ à plusieurs lignes ou un champ de texte enrichi, la présence d’un objet enfant comb ne générera pas de champ combiné au moment de l’exécution.
3.21.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.21.2. Classe parent
node class catégorie
3.21.3. Propriétés
Nom Description Type Accès
numberOfCells
Indique le nombre de cellules dessinées pour un champ peigne. Ceci n’est pas affecté par le nombre de caractères dans la valeur du champ.
Entier Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.21.4. Méthodes
Aucun
Objets de script
3.22. command
L’objet command spécifie une seule commande à exécuter sur la source de données.
3.22.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet deleteinsertqueryupdate
3.22.2. Classe parent
node class catégorie
3.22.3. Propriétés
Nom Description Type Accès
timeout Spécifie le nombre de secondes autorisé pour la tentative d’exécution de la requête.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.22.4. Méthodes
Aucun
38
Objets de script 3
3.23. connect
39
L’objet connect décrit la relation entre son objet conteneur et une connexion à un service Web, un schéma ou une description de données. Les connexions sont définies hors de la conception de formulaire dans un paquet séparé doté de son propre schéma.
3.23.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaireModèle sourceSet
connectStringpasswordpictureuser
3.23.2. Classe parent
node class catégorie
3.23.3. Propriétés
Nom Description Type Accès
connection Spécifie le nom du contrôle de connexion associé dans l’ensemble de connexions.
Chaîne Lecture/écriture
delayedOpen Spécifie la durée, en secondes, du délai d’ouverture de la source de données une fois la connexion établie.
Chaîne Lecture/écriture
ref Spécifie une expression de syntaxe de référence définissant le nœud dans le modèle de données auquel le conteneur englobant est associé.
Chaîne Lecture/écriture
timeout Spécifie le nombre de secondes autorisé pour la tentative d’exécution de la requête.
Chaîne Lecture/écriture
usage Spécifie les contextes d’utilisation de la connexion. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.23.4. Méthodes
Aucun
3.24. connectionSet
L’objet connectionSet constitue l’objet racine du modèle connectionSet.
3.24.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet wsdlConnectionxsdConnection
3.24.2. Classe parent
model, classe catégorie
3.24.3. Propriétés
Aucun
3.24.4. Méthodes
Aucun
40
Objets de script 3
3.25. connectString
41
L’objet connectString spécifie la chaîne de connexion à utiliser pour se connecter à la base de données.
3.25.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.25.2. Classe parent
textNode, classe catégorie
3.25.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.25.4. Méthodes
Aucun
Objets de script
3.26. contentArea
L’objet contentArea décrit une zone à l’intérieur d’une page pouvant recevoir du contenu.
3.26.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire descextras
3.26.2. Classe parent
container, classe
3.26.3. Propriétés
Nom Description Type Accès
h Mesure de la hauteur pour la disposition. Chaîne Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
w Mesure indiquant la largeur pour la disposition. Chaîne Lecture/écriture
x Indique la coordonnée X du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
y Indique la coordonnée Y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
42
Objets de script 3
3.26.4. Méthodes
43
Aucun
3.27. corner
L’objet corner décrit l’aspect d’un sommet entre deux bords.
3.27.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire colorextras
3.27.2. Classe parent
node class catégorie
3.27.3. Propriétés
Nom Description Type Accès
inverted Indique si un coin est convexe (les bords sont joints selon la tangente) ou s’il est inversé et prend une forme concave (les bords sont joints à angle droit).
Chaîne Lecture/écriture
join Indique la forme d’un coin. Chaîne Lecture/écriture
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
radius Indique le rayon d’un coin. Chaîne Lecture/écriture
stroke Indique l’aspect d’une ligne. Chaîne Lecture/écriture
Objets de script
thickness Indique l’épaisseur ou le poids de la ligne. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Nom Description Type Accès
3.27.4. Méthodes
Aucun
3.28. dataGroup (désapprouvé)
L’objet dataGroup est le parent d’une liste de nœuds de données XML au sein d’un fichier de données XML. Les nœuds délimités par l’objet dataGroup (désapprouvé) sont soit des valeurs de données réelles, soit d’autres objets de données XML tels qu’objets dataGroup (désapprouvés). Les sous-formulaires, tels qu’ils apparaissent dans les fichiers de données XML, sont un exemple de groupes de données.
3.28.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de données dataGroup (désapprouvé)dataValue
3.28.2. Classe parent
node class catégorie
3.28.3. Propriétés
Aucun
44
Objets de script 3
3.28.4. Méthodes
45
Aucun
3.29. dataModel
L’objet dataModel constitue l’objet racine du modèle de données.
3.29.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de données dataWindow
3.29.2. Classe parent
model, classe catégorie
3.29.3. Propriétés
Aucun
3.29.4. Méthodes
Aucun
3.30. dataValue
L’objet dataValue représente un objet conteneur prévu pour stocker une ou plusieurs valeurs. Un objet dataValue correspond, par exemple, à un champ sur un formulaire.
REMARQUE : Un objet dataValue peut posséder des objets enfant dataValue supplémentaires stockant des données complémentaires. Ce n’est généralement pas le cas.
Objets de script
3.30.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de données none
3.30.2. Classe parent
node class catégorie
3.30.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Variable Lecture/écriture
contains Spécifie si une valeur de données doit être incluse dans la valeur de l’objet parent ou en tant que propriété du parent.
Chaîne Lecture/écriture
contentType Spécifie le type de contenu présent dans le document référencé, à savoir MIME.
Chaîne Lecture/écriture
isNull Indique si la valeur de données actuelle est la valeur nulle. Booléen Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.30.4. Méthodes
Aucun
46
Objets de script 3
3.31. dataWindow
47
L’objet dataWindow représente la plage d’enregistrements de la source de données actuellement chargée dans le modèle de données.
3.31.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de données none
3.31.2. Classe parent
object, classe catégorie
3.31.3. Propriétés
Nom Description Type Accès
currentRecordNumber
Renvoie le numéro d’enregistrement actif dans la plage des enregistrements contenus dans l’objet dataWindow actif.
Entier Lecture
isDefined Indique si une fenêtre de données valide est actuellement définie.
Booléen Lecture
recordsAfter Renvoie le nombre d’enregistrements dans la fenêtre de données après l’enregistrement en cours.
Entier Lecture
recordsBefore Renvoie le nombre d’enregistrements dans la fenêtre de données avant l’enregistrement en cours.
Entier Lecture
Objets de script
3.31.4. Méthodes
Nom Description Renvoie
gotoRecord Déplace l’enregistrement actif de la fenêtre de données vers un enregistrement particulier dans la plage d’enregistrements des données.
Vide
isRecordGroup Indique si un objet dataGroup particulier est également un enregistrement unique.
Booléen
moveCurrentRecord Place l’enregistrement actif dans un autre emplacement dans la plage des enregistrements.
Vide
record Renvoie un enregistrement dans une position relative à l’enregistrement actif. Objet
3.32. date
L’objet date décrit une date de calendrier.
3.32.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.32.2. Classe parent
content, classe catégorie
48
Objets de script 3
3.32.3. Propriétés
49
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.32.4. Méthodes
Aucun
3.33. dateTime
L’objet dateTime représente une valeur de date et d’heure.
3.33.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.33.2. Classe parent
node class catégorie
Objets de script
3.33.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.33.4. Méthodes
Aucun
3.34. dateTimeEdit
L’objet dateTimeEdit décrit une commande destinée à faciliter la sélection de la date et de l’heure.
3.34.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire bordercombextrasmargin
3.34.2. Classe parent
node class catégorie
50
Objets de script 3
3.34.3. Propriétés
51
Nom Description Type Accès
hScrollPolicy Indique si un champ peut défiler horizontalement. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.34.4. Méthodes
Aucun
3.35. decimal
L’objet decimal représente un nombre composé d’un nombre de chiffres fixe après la virgule.
3.35.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.35.2. Classe parent
content, classe catégorie
Objets de script
3.35.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Double Lecture/écriture
fracDigits Indique le nombre maximum de chiffres (inclusifs) suivant la décimale à capturer et à stocker.
Chaîne Lecture/écriture
leadDigits Indique le nombre maximum de chiffres (inclusifs) précédant la décimale à capturer et à stocker.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.35.4. Méthodes
Aucun
3.36. defaultUi (désapprouvé)
L’objet defaultUi contrôle la représentation des objets dont l’aspect est délégué à l’application.
3.36.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.36.2. Classe parent
node class catégorie
52
Objets de script 3
3.36.3. Propriétés
53
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.36.4. Méthodes
Aucun
3.37. delete
L’objet delete spécifie l’opération de suppression de l’enregistrement en cours de la source de données.
3.37.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.37.2. Classe parent
textNode, classe catégorie
Objets de script
3.37.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.37.4. Méthodes
Aucun
3.38. desc
L’objet desc décrit des métadonnées affichables.
3.38.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.38.2. Classe parent
node class catégorie
54
Objets de script 3
3.38.3. Propriétés
55
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.38.4. Méthodes
Nom Description Renvoie
metadata Collecte un paquet de métadonnées XMP (Extensible Metadata Platform) complet pour le document.
Chaîne
3.39. digestMethod
L’objet digestMethod répertorie un ensemble d’algorithmes digest pouvant être utilisés lors de la signature. Les valeurs valides pour PDF 1.7 sont SHA1, SHA256, SHA384, SHA512 et RIPEMD160.
Cet objet s’applique uniquement si les informations d’identification numériques qu’utilise un utili-sateur contiennent des clés RSA publiques ou privées. Si elles contiennent des clés DSA publiques ou privées, l’algorithme digest est toujours SHA1 et cet objet n’est pas pris en compte. La valeur par défaut, si elle n’est pas spécifiée, dépend de l’implémentation.
3.39.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.39.2. Classe parent
node class catégorie
Objets de script
3.39.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.39.4. Méthodes
Aucun
3.40. digestMethods
L’objet digestMethods contient une liste des valeurs d’objet digestMethod acceptées. Si les informations d’identification contiennent des clés RSA publiques ou privées, les valeurs valides sont SHA1, SHA256, SHA384, SHA512, RIPEMD160. Si les informations d’identification contiennent des clés DSA publiques ou privées, la seule valeur valide est SHA1.
3.40.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire digestMethod
3.40.2. Classe parent
node class catégorie
56
Objets de script 3
3.40.3. Propriétés
57
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Read \Write
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.40.4. Méthodes
Aucun
3.41. draw
L’objet draw contient le contenu non interactif de la conception de formulaire. Par exemple, dans Designer, l’objet draw décrit les objets de texte, d’image statique, de cercle, de ligne et de rectangle.
3.41.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire assistbordercaptiondescextrasfontkeepmarginparatraversaluivalue
Objets de script
3.41.2. Classe parent
container, classe
3.41.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
anchorType Indique l’emplacement du point d’ancrage du conteneur lors de l’utilisation d’une stratégie de disposition positionnée.
Chaîne Lecture/écriture
colSpan Spécifie le nombre de colonnes étendues par cet objet lorsqu’il est incorporé dans un sous-formulaire doté d’un type de disposition des rangées particulier.
Chaîne Lecture/écriture
h Mesure de la hauteur pour la disposition. Chaîne Lecture/écriture
hAlign Indique l’alignement de texte horizontal. Chaîne Lecture/écriture
locale Indique la langue, la devise et le format de date/heure à utiliser pour le contenu de l’objet.
Chaîne Lecture/écriture
maxH Indique la hauteur maximale à des fins de disposition. Chaîne Lecture/écriture
maxW Indique la largeur maximale à des fins de disposition. Chaîne Lecture/écriture
minH Indique la hauteur maximale à des fins de disposition. Chaîne Lecture/écriture
minW Indique la largeur maximale à des fins de disposition. Chaîne Lecture/écriture
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
rawValue Indique la valeur non formatée de l’objet actuel. Chaîne Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
58
Objets de script 3
59
rotate Fait pivoter l’objet autour de son point d’ancrage selon l’angle indiqué. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
vAlign Indique l’alignement de texte vertical. Chaîne Lecture/écriture
w Mesure indiquant la largeur pour la disposition. Chaîne Lecture/écriture
x Indique la coordonnée X du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
y Indique la coordonnée Y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
Nom Description Type Accès
3.41.4. Méthodes
Aucun
3.42. dSigData
L’objet dSigData décrit une unité de données de signature numérique XML.
3.42.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
Objets de script
3.42.2. Classe parent
node class catégorie
3.42.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.42.4. Méthodes
Nom Description Renvoie
getAttribute Récupère une valeur de propriété spécifiée. Chaîne
3.42.5. edge
L’objet edge décrit un arc, une ligne, ou le côté d’une bordure ou d’un rectangle.
ASTUCE : Dans le cas où l’objet edge décrit le côté d’une bordure ou d’un rectangle, un objet corner décrit le sommet entre deux objets edge. Si vous essayez de modifier les propriétés de l’objet edge pour obtenir un comportement, par exemple pour modifier la couleur de la bordure d’un objet de formulaire, il se peut que vous ayez aussi à régler la couleur des objets corner.
3.42.6. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire colorextras
60
Objets de script 3
3.42.7. Classe parent
61
node class catégorie
3.42.8. Propriétés
Nom Description Type Accès
cap Spécifie le rendu d’extrémité du contour. Chaîne Lecture/écriture
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
stroke Indique l’aspect d’une ligne. Chaîne Lecture/écriture
thickness Indique l’épaisseur ou le poids de la ligne. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.42.9. Méthodes
Aucun
3.43. effectiveInputPolicy
L’objet effectiveInputPolicy est utilisé pour la demande du service Web. Seul l’objet effectiveInputPolicy contient des informations de stratégie d’authentification, car les serveurs ne sont pas requis pour s’authentifier sur le client.
3.43.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet Aucun
Objets de script
3.43.2. Classe parent
node class catégorie
3.43.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.43.4. Méthodes
Aucun
3.44. effectiveOutputPolicy
L’objet effectiveOutputPolicy est utilisé pour le résultat d’un service Web d’une demande d’un service Web. L’objet effectiveOutputPolicy est toujours vide.
3.44.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet Aucun
3.44.2. Classe parent
node class catégorie
62
Objets de script 3
3.44.3. Propriétés
63
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.44.4. Méthodes
Aucun
3.45. encoding
L’objet encoding correspond à l’élément PDFL subFilters. Les valeurs valides pour Adobe sont adbe.x509.rsa_sha1, adbe.pkcs7.detached et adbe.pkcs7.sha1, mais d’autres gestionnaires de protection peuvent définir leurs propres valeurs.
3.45.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.45.2. Classe parent
node class catégorie
3.45.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.45.4. Méthodes
Aucun
3.46. encodings
L’objet encodings contient une liste des valeurs d’objet encoding acceptées.
3.46.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire encoding
3.46.2. Classe parent
node class catégorie
3.46.3. Propriétés
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.46.4. Méthodes
Aucun
64
Objets de script 3
3.47. encrypt
65
L’objet encrypt permet de chiffrer les données de formulaire lors de son envoi. Il contient un objet certificate qui contient une clé publique pour le mode de chiffrement. La méthode de chiffrement utilisée dépend de la valeur de la propriété format.
3.47.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire certificate
3.47.2. Classe parent
node class catégorie
3.47.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.47.4. Méthodes
Aucun
Objets de script
3.48. event
L’objet event provoque l’exécution d’un script ou l’envoi de données lors d’un événement particulier.
3.48.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.48.2. Classe parent
node class catégorie
3.48.3. Propriétés
Nom Description Type Accès
activity Indique le nom de l’événement. Chaîne Lecture/écriture
listen Contrôle si l’objet d’événement réagit aux événements ayant lieu dans le nœud référencé uniquement ou aux événements se produisant dans le nœud référencé et ses descendants.
Chaîne Lecture/écriture
ref Spécifie une expression de syntaxe de référence définissant le nœud dans le modèle de données auquel le conteneur englobant est associé.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.48.4. Méthodes
Aucun
66
Objets de script 3
3.49. eventPseudoModel
67
L’objet eventPseudoModel constitue l’objet racine du modèle d’événement.
3.49.1. Hiérarchie des objets
Modèle Objets enfant
Modèle Event Aucun
3.49.2. Classe parent
object, classe catégorie
3.49.3. Propriétés
Nom Description Type Accès
cancelAction Indique s’il est nécessaire ou non d’annuler une action à venir. Cette propriété ne s’applique qu’aux événements de scripts suivants : prePrint, preSubmit, preExecute, preOpen et preSign.
Booléen Lecture/écriture
change Indique la valeur saisie ou collée par un utilisateur dans un champ immédiatement après avoir effectué une opération.
Chaîne Lecture/écriture
commitKey Indique comment l’utilisateur a défini la valeur actuelle d’un champ de formulaire.
Entier Lecture/écriture
fullText Représente la valeur pleine (non tronquée) que l’utilisateur colle dans un champ de formulaire.
Chaîne Lecture/écriture
keyDown Détermine si un utilisateur appuie sur une touche fléchée pour effectuer une sélection. Cette propriété est uniquement disponible pour les zones de liste et les listes déroulantes.
Booléen Lecture/écriture
modifier Détermine l’utilisation de la touche de modification (par exemple, Ctrl sous Microsoft® Windows®) lors de l’exécution d’un événement particulier.
Booléen Lecture/écriture
newContentType Indique le type de contenu de la propriété newText. Chaîne Lecture/écriture
Objets de script
newText Indique le contenu du champ une fois qu’il a été modifié suite aux actions de l’utilisateur.
Chaîne Lecture/écriture
prevContentType Indique le type de contenu de la valeur spécifiée pour la propriété prevText.
Chaîne Lecture/écriture
prevText Indique le contenu du champ avant qu’il soit modifié suite aux actions de l’utilisateur.
Chaîne Lecture/écriture
reenter Indique si l’événement enter se produit pour la première fois. L’événement enter se produit chaque fois qu’un utilisateur clique sur un champ.
Booléen Lecture/écriture
selEnd Indique la position de l’index pour le dernier caractère de la sélection de texte stockée dans la propriété prevTextlors d’un événement de modification.
Entier Lecture/écriture
selStart Indique la position de l’index pour le premier caractère de la sélection de texte stockée dans la propriété prevText lors d’un événement de modification.
Entier Lecture/écriture
shift Indique si la touche Maj est enfoncée lors d’un événement donné. Booléen Lecture/écriture
soapFaultCode Indique tout code incorrect survenant lors de la tentative d’exécution par l’utilisateur d’une connexion au service Web.
Chaîne Lecture/écriture
soapFaultString Indique le message descriptif correspondant à un code incorrect lors de la connexion à un service Web particulier.
Chaîne Lecture/écriture
target Indique l’objet sur lequel l’action se produit. Chaîne Lecture/écriture
Nom Description Type Accès
3.49.4. Méthodes
Nom Description Renvoie
emit Indique au gestionnaire d’événement de formulaire qu’un événement est survenu. Vide
reset Réinitialise toutes les propriétés dans le modèle d’événement du formulaire XML. Vide
68
Objets de script 3
3.50. exclGroup
69
L’objet exclGroup décrit une relation d’exclusion mutuelle entre conteneurs.
Un groupe d’exclusion est utilisé pour provoquer l’exclusion mutuelle de boutons radio. Lorsqu’un utilisateur active un membre de la série, les autres membres sont automatiquement désactivés. Par exemple, si le jeu se compose de boutons radio, l’activation d’un bouton particulier provoque la désactivation des autres boutons.
Chaque membre du groupe d’exclusion est associé à une valeur on et une valeur off. Lorsqu’un membre est activé, la valeur on. Lorsqu’il est désactivé, la valeur off. L’objet on pour chaque membre d’un groupe d’exclusion particulier doit être unique.
Lorsque un membre est sélectionné dans le groupe d’exclusion du formulaire, la valeur de chaque membre est définie sur on ou off, selon le cas. De la même façon, lorsque la valeur on est affectée à un membre du groupe d’exclusion, les autres membres sont désactivés.
Une valeur peut également être associée au groupe d’exclusion lui-même. Dans ce cas, chaque membre n’est activé que si la valeur correspond à la valeur on de ce membre.
3.50.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire assistbindbordercalculatecaptiondesc
extrasfieldmarginparatraversalvalidate
3.50.2. Classe parent
node class catégorie
Objets de script
3.50.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
access Définit l’accès de l’utilisateur au contenu d’un objet conteneur, tel qu’un sous-formulaire.
Chaîne Lecture/écriture
accessKey Spécifie une touche d’accès rapide utilisée par une application interactive pour déplacer la cible d’action vers un élément de champ particulier.
Chaîne Lecture/écriture
anchorType Indique l’emplacement du point d’ancrage du conteneur lors de l’utilisation d’une stratégie de disposition positionnée.
Chaîne Lecture/écriture
borderColor Indique la valeur de la couleur de la bordure pour ce champ. Chaîne Lecture/écriture
borderWidth Indique la largeur de la bordure pour ce champ. Chaîne Lecture/écriture
colSpan Spécifie le nombre de colonnes étendues par cet objet lorsqu’il est incorporé dans un sous-formulaire doté d’un type de disposition des rangées particulier.
Chaîne Lecture/écriture
errorText Renvoie le message de validation du premier test de validation ayant échoué ou une chaîne vide si ce champ a passé avec succès tous les tests de validation.
Chaîne Lecture
fillColor Valeur de la couleur d’arrière-plan pour ce champ. Chaîne Lecture/écriture
h Mesure de la hauteur pour la disposition. Chaîne Lecture/écriture
hAlign Indique l’alignement de texte horizontal. Chaîne Lecture/écriture
layout Indique la stratégie de disposition utilisée par cet objet. Chaîne Lecture/écriture
mandatory Indique la valeur nullTest pour le champ. Chaîne Lecture/écriture
mandatoryMessage Indique la chaîne de message obligatoire pour ce champ. Chaîne Lecture/écriture
maxH Indique la hauteur maximale à des fins de disposition. Chaîne Lecture/écriture
70
Objets de script 3
71
maxW Indique la largeur maximale à des fins de disposition. Chaîne Lecture/écriture
minH Indique la hauteur maximale à des fins de disposition. Chaîne Lecture/écriture
minW Indique la largeur maximale à des fins de disposition. Chaîne Lecture/écriture
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
rawValue Indique la valeur non formatée de l’objet actuel. Chaîne Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
transient Spécifie si l’application de traitement doit sauvegarder la valeur du groupe d’exclusion lors de l’envoi du formulaire ou d’une opération de sauvegarde.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
validationMessage Indique la chaîne de message de validation pour ce champ. Chaîne Lecture/écriture
vAlign Indique l’alignement de texte vertical. Chaîne Lecture/écriture
w Mesure indiquant la largeur pour la disposition. Chaîne Lecture/écriture
x Indique la coordonnée X du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
y Indique la coordonnée Y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
Nom Description Type Accès
Objets de script
3.50.4. Méthodes
Nom Description Renvoie
execCalculate Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execEvent Exécute le script d’événement de l’objet. Vide
execInitialize Exécute tous les scripts sur l’événement initialize de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execValidate Exécute tous les scripts sur l’événement validate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
selectedMember Renvoie le membre sélectionné d’un groupe d’exclusion. Objet
3.51. exData
L’objet exData décrit un type de données étranger.
3.51.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.51.2. Classe parent
content, classe catégorie
72
Objets de script 3
3.51.3. Propriétés
73
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
contentType Spécifie le type de contenu présent dans le document référencé, à savoir MIME.
Chaîne Lecture/écriture
href Indique une référence à un fichier ou à une ressource externe. Chaîne Lecture/écriture
maxLength Spécifie la longueur de contenu maximale autorisée (incluse) ou 1 pour indiquer qu’aucune longueur maximale n’est imposée.
Chaîne Lecture/écriture
transferEncoding Indique le codage du contenu binaire dans le document référencé. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.51.4. Méthodes
Aucun
3.52. execute
L’objet execute contrôle à quel emplacement un événement est géré.
3.52.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
Objets de script
3.52.2. Classe parent
node class catégorie
3.52.3. Propriétés
Nom Description Type Accès
connection Spécifie le nom du contrôle de connexion associé dans l’ensemble de connexions.
Chaîne Lecture/écriture
executeType Indique s’il faut importer les nouvelles données dans le formulaire existant ou les fusionner dans la conception de formulaire initiale en vue d’obtenir un nouveau formulaire.
Chaîne Lecture/écriture
runAt Indique quelle application peut exécuter le script. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.52.4. Méthodes
Aucun
3.53. exObject
L’objet exObject décrit un programme unique ou un objet étranger particulier à un type d’implé-mentation.
3.53.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
74
Objets de script 3
3.53.2. Classe parent
75
node class catégorie
3.53.3. Propriétés
Nom Description Type Accès
archive Spécifie l’emplacement URI d’un fichier d’archive pouvant contenir un code de programmation associé à l’objet exObject.
Chaîne Lecture/écriture
classId Spécifie un nom ou un emplacement URI pour le code de programmation représenté par l’objet.
Chaîne Lecture/écriture
codeBase Spécifie un emplacement URI pouvant être utilisé pour faciliter la résolution d’une propriété classId .
Chaîne Lecture/écriture
codeType Spécifie un identifiant de type MIME capable d’identifier le code de programmation représenté par l’objet.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.53.4. Méthodes
Aucun
3.54. extras
L’objet extras joue le rôle d’enceinte autour d’un ou de plusieurs jeux de propriétés personnalisées. Le contenu de cet objet peut être utilisé par des applications personnalisées.
3.54.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaireModèle sourceSet
none
Objets de script
3.54.2. Classe parent
node class catégorie
3.54.3. Propriétés
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.54.4. Méthodes
Aucun
3.55. field
L’objet field décrit un conteneur interactif unique pouvant capturer et présenter un contenu de données.
En termes d’objets disponibles dans la Bibliothèque d’objets de Designer, l’objet de champ est la définition XML de base pour les objets suivants :
• Codes à barres
• Bouton
• Date/Heure
• Champ décimal
• Champ de signature
• Bouton Envoyer par messagerie
• Bouton Envoyer via HTTP
• Champ d’image
76
Objets de script 3
77
• Champ numérique
• Code à barres de formulaires pour support papier
• Champ du mot de passe
• Bouton Imprimer
• Bouton Réinitialiser
• Champ de texte
Vous pouvez définir des messages de validation personnalisés. Un champ unique peut contenir jusqu’à trois messages, un pour le test de script, pour le test d’image et pour le test null. Une fois spécifiés, ils peuvent être accédés au moyen de la syntaxe suivante :
field.validate.message.scriptTest.value field.validate.message.formatTest.value field.validate.message.nullTest.value
Vous pouvez aussi accéder à ces messages de validation à l’aide de leurs propriétés raccourci.
field.validationMessage field.formatMessage field.mandatoryMessage
Lorsque ces valeurs ne sont pas remplies, le processeur construit un message par défaut.
Un champ peut avoir au maximum un test de validation en état d’échec à un moment donné. Les tests de validation sont évalués dans l’ordre suivant, et l’évaluation s’arrête au premier test qui échoue :
1) nullTest
2) formatTest
3) scriptTest
3.55.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire assistbindbordercalculatecaptionconnectdescextrasfont
formatitemskeepmarginparatraversaluivalidatevalue
Objets de script
3.55.2. Classe parent
container, classe
3.55.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Variable Lecture/écriture
access Définit l’accès de l’utilisateur au contenu d’un objet conteneur, tel qu’un sous-formulaire.
Chaîne Lecture/écriture
accessKey Spécifie une touche d’accès rapide utilisée par une application interactive pour déplacer la cible d’action vers un élément de champ particulier.
Chaîne Lecture/écriture
anchorType Indique l’emplacement du point d’ancrage du conteneur lors de l’utilisation d’une stratégie de disposition positionnée.
Chaîne Lecture/écriture
borderColor Indique la valeur de la couleur de la bordure pour ce champ. Chaîne Lecture/écriture
borderWidth Indique la largeur de la bordure pour ce champ. Chaîne Lecture/écriture
colSpan Spécifie le nombre de colonnes étendues par cet objet lorsqu’il est incorporé dans un sous-formulaire doté d’un type de disposition des rangées particulier.
Chaîne Lecture/écriture
editValue Indique la valeur d’édition pour le champ. Chaîne Lecture/écriture
errorText Renvoie le message de validation du premier test de validation ayant échoué ou une chaîne vide si ce champ a passé avec succès tous les tests de validation.
Chaîne Lecture
fillColor Valeur de la couleur d’arrière-plan pour ce champ. Chaîne Lecture/écriture
fontColor Spécifie la valeur de la couleur de premier plan pour ce champ. Elle équivaut à l’expression font.fill.color.value.
Chaîne Lecture/écriture
formatMessage Indique la chaîne de message pour la validation du format pour ce champ.
Chaîne Lecture/écriture
formattedValue Indique la valeur formatée pour le champ. Chaîne Lecture/écriture
78
Objets de script 3
79
h Mesure de la hauteur pour la disposition. Chaîne Lecture/écriture
hAlign Indique l’alignement de texte horizontal. Chaîne Lecture/écriture
length Indique le nombre d’objets dans la liste. Entier Lecture
locale Indique la langue, la devise et le format de date/heure à utiliser pour le contenu de l’objet.
Chaîne Lecture/écriture
mandatory Indique la valeur nullTest pour le champ. Chaîne Lecture/écriture
mandatoryMessage Indique la chaîne de message obligatoire pour ce champ. Chaîne Lecture/écriture
maxH Indique la hauteur maximale à des fins de disposition. Chaîne Lecture/écriture
maxW Indique la largeur maximale à des fins de disposition. Chaîne Lecture/écriture
minH Indique la hauteur maximale à des fins de disposition. Chaîne Lecture/écriture
minW Indique la largeur maximale à des fins de disposition. Chaîne Lecture/écriture
parentSubform Indique le sous-formulaire (page) parent du champ. Objet Lecture
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
rawValue Indique la valeur non formatée de l’objet actuel. Variable Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
rotate Fait pivoter l’objet autour de son point d’ancrage selon l’angle indiqué.
Chaîne Lecture/écriture
selectedIndex Index du premier élément sélectionné. Entier Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
Nom Description Type Accès
Objets de script
usehref Appelle un prototype externe. Chaîne Lecture/écriture
validationMessage Indique la chaîne de message de validation pour ce champ. Chaîne Lecture/écriture
vAlign Indique l’alignement de texte vertical. Chaîne Lecture/écriture
w Mesure indiquant la largeur pour la disposition. Chaîne Lecture/écriture
x Indique la coordonnée X du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
y Indique la coordonnée Y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
Nom Description Type Accès
3.55.4. Méthodes
Nom Description Renvoie
addItem Ajoute de nouveaux éléments au champ de formulaire actuel. Par exemple, cette méthode permet d’ajouter des éléments à une liste déroulante.
Vide
boundItem Récupère la valeur liée d’un élément d’affichage spécifique dans une liste déroulante ou une zone de liste.
Chaîne
clearItems Supprime tous les éléments du champ. Cette méthode supprime par exemple tous les éléments contenus dans une zone de liste ou une liste déroulante.
Vide
deleteItem Supprime l’élément spécifié. Booléen
execCalculate Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execEvent Exécute le script d’événement de l’objet. Vide
execInitialize Exécute tous les scripts sur l’événement initialize de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execValidate Exécute tous les scripts sur l’événement validate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
getDisplayItem Récupère le texte d’affichage de l’élément pour l’index d’élément spécifié. Chaîne
80
Objets de script 3
81
getItemState Renvoie l’état de sélection de l’élément spécifié. Booléen
getSaveItem Récupère la valeur de données pour l’index d’élément spécifié. Chaîne
setItemState Définit l’état de sélection de l’élément spécifié. Vide
setItems Ajoute de nouveaux éléments et de nouvelles valeurs au champ de formulaire actuel. Par exemple, cette méthode permet d’ajouter des éléments et des valeurs comme arguments à une liste déroulante.
Vide
Nom Description Renvoie
3.56. fill
L’objet fill applique une couleur et des conceptions rendues facultatives à la zone délimitée par un objet.
3.56.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire colorextras
3.56.2. Classe parent
node class catégorie
3.56.3. Propriétés
Nom Description Type Accès
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.56.4. Méthodes
Aucun
3.57. filter
L’objet filter décrit les critères de filtrage des certificats signés. Les certificats signés sont utilisés pour générer des signatures de données conformément aux normes W3C XML.
3.57.1. Hiérarchie des objets
Les objets enfant mdp, reasons et timestamp ne sont valides que si l’objet parent est signature. Si l’objet parent est signData, Designer ne prend pas en compte ces objets enfant et ne les génère pas.
Modèle Objets enfant
Modèle de formulaire certificatesdigestMethodsencodingshandlermdpreasonstimeStamp
3.57.2. Classe parent
node class catégorie
3.57.3. Propriétés
Nom Description Type Accès
addRevocationInfo
Indique si l’état du certificat est vérifié lorsqu’une signature numérique est signée. L’état du certificat peut être vérifié à l’aide d’une liste de révocation des certificats ou d’une réponse OCSP (Online Certificate Status Protocol).
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
82
Objets de script 3
83
usehref Appelle un prototype externe. Chaîne Lecture/écriture
version Indique le numéro de version de l’application active.
Nom Description Type Accès
3.57.4. Méthodes
Aucun
3.58. float
L’objet float décrit une valeur à virgule flottante.
3.58.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.58.2. Classe parent
content, classe catégorie
3.58.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Double Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Double Lecture/écriture
Objets de script
3.58.4. Méthodes
Aucun
3.59. font
L’objet font décrit une police utilisée sur un formulaire.
3.59.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extrasfill
3.59.2. Classe parent
node class catégorie
3.59.3. Propriétés
Nom Description Type Accès
baselineShift Indique une mesure positive permettant de décaler une police vers le haut par rapport à la ligne de base ou indique une mesure négative décalant une police vers le bas par rapport à la ligne de base.
Chaîne Lecture/écriture
fontHorizontalScale Met à l’échelle les glyphes de police horizontalement. Chaîne Lecture/écriture
fontVerticalScale Met à l’échelle les glyphes de police verticalement. Chaîne Lecture/écriture
kerningMode Applique le crénage aux caractères. Chaîne Lecture/écriture
84
Objets de script 3
85
letterSpacing Définit la limite d’espacement. Chaîne Lecture/écriture
lineThrough Indique l’activation d’une ligne simple ou double traversant le texte (propriété également connue sous le nom de texte barré).
Chaîne Lecture/écriture
lineThroughPeriod Contrôle l’aspect de la ligne sur le texte (propriété également connue sous le nom de texte barré).
Chaîne Lecture/écriture
posture Indique le style d’une police. Chaîne Lecture/écriture
size Mesure indiquant la taille du contour de la case à cocher ou du bouton radio, soit la hauteur et la largeur s’il s’agit d’une case à cocher, soit le diamètre s’il s’agit d’un bouton radio.
Chaîne Lecture/écriture
typeface Indique le nom d’une police de caractères. Chaîne Lecture/écriture
underline Indique l’activation et le type de soulignement. Chaîne Lecture/écriture
underlinePeriod Contrôle l’aspect du soulignement. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
weight Définit l’épaisseur d’une police de caractères. Chaîne Lecture/écriture
Nom Description Type Accès
3.59.4. Méthodes
Aucun
Objets de script
3.60. form
L’objet form constitue l’objet racine du modèle de formulaire.
3.60.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire descextras
3.60.2. Classe parent
model, classe catégorie
3.60.3. Propriétés
Nom Description Type Accès
checksum Indique un algorithme de la somme de contrôle à insérer dans un code à barres.
Chaîne Lecture/écriture
3.60.4. Méthodes
Nom Description Renvoie
execCalculate Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execInitialize Exécute tous les scripts sur l’événement initialize de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execValidate Exécute tous les scripts sur l’événement validate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
formNodes Renvoie la liste de tous les objets de modèle du formulaire liés à un objet de données spécifié.
Objet
86
Objets de script 3
87
metadata Collecte un paquet de métadonnées XMP (Extensible Metadata Platform) complet pour le document.
Chaîne
recalculate Force l’exécution d’un jeu spécifique de scripts sur des événements de calculs. Les événements spécifiques peuvent être des événements de calculs en attente ou l’intégralité des événements de calculs.
Vide
remerge Force la fusion des modèles de données et la conception de modèle pour recréer un modèle de formulaire. Une fois la fusion effectuée, tout traitement de modèle de disposition doit être à nouveau effectué pour déterminer le formulaire.
Vide
Nom Description Renvoie
3.61. format
L’objet format renferme des informations relatives au formatage des valeurs d’entrée ou de sortie, telles que la clause d’image.
3.61.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extraspicture
3.61.2. Classe parent
node class catégorie
3.61.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.61.4. Méthodes
Aucun
3.62. handler
L’objet handler contrôle le gestionnaire de signatures utilisé pour les opérations de signature de données, conformément aux normes W3C XML.
3.62.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.62.2. Classe parent
textNode, classe catégorie
3.62.3. Propriétés
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.62.4. Méthodes
Aucun
88
Objets de script 3
3.63. hostPseudoModel
89
L’objet hostPseudoModel constitue l’objet racine du modèle d’hôte. Utilisez les propriétés et méthodes de l’hôte au moment de l’exécution.
Des exemples d’hôtes incluent Acrobat et XFAPresentationAgent (serveur). Il se peut que certains hôtes ne prennent pas en charge toutes les propriétés et les méthodes. Par exemple, XFAPresentatio-nAgent ne prend pas en charge xfa.host.messageBox.
Les propriétés ou les méthodes renvoient des valeurs différentes en fonction de l’agent de rendu. Exécutés sur un serveur, les scripts renvoient des valeurs de l’environnement serveur. Exécutés sur un client, comme Adobe Acrobat ou un navigateur Web, les scripts renvoient les valeurs du client. Par exemple, xfa.host.version renvoie la version de XMLFM lorsqu’il est exécuté sur un serveur et renvoie la version d’Adobe Acrobat quand il est exécuté sur ce dernier.
Pour obtenir les résultats souhaités, développer en fonction de ces différences de l’API.
3.63.1. Hiérarchie des objets
Modèle Objets enfant
Modèle Host Aucun
3.63.2. Classe parent
object, classe catégorie
3.63.3. Propriétés
Nom Description Type Accès
appType Indique le nom de l’application cliente contenant un formulaire existant.
Chaîne Lecture
calculationsEnabled
Indique si les scripts de calcul seront exécutés ou non. Booléen Lecture/écriture
currentPage Définit la page active d’un document lors de l’exécution. Entier Lecture/écriture
language Renvoie la langue de l’application hôte en cours d’exécution. Chaîne Lecture
Objets de script
numPages Renvoie le nombre de pages que compte le document actif. Entier Lecture
platform Renvoie la plate-forme de l’ordinateur qui exécute le script. Chaîne Lecture
titre Définit et obtient le titre du document. Cette méthode est uniquement disponible pour les applications client.
Chaîne Lecture/écriture
validationsEnabled Indique si les scripts de validation seront exécutés ou non. Booléen Lecture/écriture
variation Indique le conditionnement de l’application exécutant le script. Chaîne Lecture
version Indique le numéro de version de l’application active. Chaîne Lecture
Nom Description Type Accès
3.63.4. Méthodes
Nom Description Renvoie
beep Entraîne l’émission d’un son par le système. Cette méthode est uniquement disponible pour les applications client.
Vide
currentDateTime (currentDateTime)Renvoie la date et l’heure actuelles au format ISO 8601 (AAAAMMJJTHHMMSS).
Chaîne
documentCountInBatch Détermine le nombre de documents dans le lot actuel. Entier
documentInBatch Détermine le numéro du document actuel au sein du lot. Entier
exportData Exporte dans un fichier les données contenues dans le formulaire actif au format XDP ou XML.
Vide
getFocus Recherche et renvoie l’objet de formulaire qui est actuellement la cible d’action.
Objet
gotoURL Récupère l’URL spécifiée. Cette méthode est uniquement disponible pour les applications client.
Vide
importData Importe les données d’un fichier spécifié dans le formulaire actif. Vide
messageBox Affiche à l’écran une boîte de dialogue. Cette méthode est uniquement disponible pour les applications client.
Entier
openList Ouvre une liste déroulante spécifiée par l’expression de syntaxe de référence. Vide
pageDown Atteint la page suivante d’un formulaire. Utilise la méthode pageDown lors de l’exécution.
Vide
90
Objets de script 3
91
pageUp Atteint la page précédente d’un formulaire. Utilise la méthode pageUp lors de l’exécution.
Vide
print Imprime un nombre de pages spécifique à partir d’un document. Cette méthode est uniquement disponible pour les applications client.
Vide
resetData Rétablit les valeurs par défaut des champs dans un document. Vide
response Affiche une boîte de dialogue contenant une question et un champ de saisie permettant à l’utilisateur de répondre à la question. La valeur renvoyée est une chaîne contenant la réponse de l’utilisateur. Si l’utilisateur clique sur le bouton Annuler dans la boîte de dialogue, la réponse est nulle.
Chaîne
setFocus Définit la sélection au clavier sur l’objet de formulaire défini par l’expression de syntaxe de référence.
Vide
Nom Description Renvoie
3.64. hyphenation
L’objet hyphenation spécifie les propriétés de césure par défaut à appliquer au contenu d’un conteneur englobant.
3.64.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.64.2. Classe parent
node class catégorie
Objets de script
3.64.3. Propriétés
Nom Description Type Accès
excludeAllCaps Indique s’il faut ou non appliquer la césure aux mots écrits entièrement en majuscules.
Chaîne Lecture/écriture
excludeInitialCap Indique s’il faut ou non appliquer la césure aux mots dont l’initiale est une lettre majuscule.
Chaîne Lecture/écriture
hyphenate Indique si la césure est permise ou non. Chaîne Lecture/écriture
ladderCount Définit le nombre maximum de lignes consécutives auxquelles la césure peut s’appliquer.
Chaîne Lecture/écriture
pushCharacterCount
Définit le nombre minimum de groupes de graphèmes (à l’exception des glyphes de césure ajoutés en début de ligne suivante) autorisés dans un suffixe en cas de césure. Si le suffixe est trop court, le candidat est refusé.
Chaîne Lecture/écriture
remainCharacterCount
Définit le nombre minimum de groupes de graphèmes (à l’exception des glyphes de césure ajoutés en fin de ligne) autorisés dans un préfixe en cas de césure. Si le préfixe est trop court, le candidat est refusé.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
wordCharacterCount
Définit le nombre minimum de groupes de graphèmes nécessaires pour appliquer la césure à un mot. Les mots n’ayant pas suffisamment de groupes de graphèmes ne peuvent pas faire l’objet d’une césure.
Chaîne Lecture/écriture
3.64.4. Méthodes
Aucun
92
Objets de script 3
3.65. image
93
L’objet image décrit une image unique sur un formulaire.
3.65.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.65.2. Classe parent
node class catégorie
3.65.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture
aspect Indique le mode de mappage de l’image à la zone de contenu nominale du conteneur de l’image.
Chaîne Lecture/écriture
contentType Spécifie le type de contenu présent dans le document référencé, à savoir MIME.
Chaîne Lecture/écriture
href Indique une référence à un fichier ou à une ressource externe. Chaîne Lecture/écriture
transferEncoding Indique le codage du contenu binaire dans le document référencé.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture
Objets de script
3.65.4. Méthodes
Aucun
3.66. imageEdit
L’objet imageEdit renferme des commandes destinées à faciliter la manipulation des contenus d’image.
3.66.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire borderextrasmargin
3.66.2. Classe parent
node class catégorie
3.66.3. Propriétés
Nom Description Type Accès
data Indique si l’image fournie au widget doit être désignée comme référence ou incorporée.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.66.4. Méthodes
Aucun
94
Objets de script 3
3.67. insert
95
L’objet insert spécifie l’opération d’insertion de l’enregistrement en cours de la source de données.
3.67.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.67.2. Classe parent
textNode, classe catégorie
3.67.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.67.4. Méthodes
Aucun
Objets de script
3.68. instanceManager
L’objet instanceManager gère la création, la suppression et le déplacement de l’instance des objets de modèle de formulaire.
3.68.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire occur
3.68.2. Classe parent
node class catégorie
3.68.3. Propriétés
Nom Description Type Accès
count Indique le nombre actuel d’instances de sous-formulaire sur un formulaire.
Chaîne Lecture/écriture
max Indique le nombre maximal d’occurrences pour le conteneur qui englobe ou -1 pour ne définir aucune limite supérieure pour les occurrences.
Chaîne Lecture
min Indique le nombre minimal d’occurrences du conteneur englobant. Chaîne Lecture
3.68.4. Méthodes
Nom Description Renvoie
addInstance Ajoute une instance d’un sous-formulaire ou d’un jeu de sous-formulaires au modèle de formulaire.
Objet
insertInstance Insère une nouvelle instance d’un sous-formulaire ou d’un jeu de sous-formulaires à un formulaire.
Objet
96
Objets de script 3
97
moveInstance Déplace un objet de sous-formulaire au sein d’un jeu d’instances de sous-formulaire.
Vide
removeInstance Supprime un sous-formulaire ou un jeu de sous-formulaires spécifique du modèle de formulaire.
Vide
setInstances Ajoute ou supprime les sous-formulaires ou jeux de sous-formulaires spécifiés du modèle de formulaire.
Vide
Nom Description Renvoie
3.69. integer
L’objet integer décrit une valeur sous forme d’entier.
3.69.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaireModèle sourceSet
Aucun
3.69.2. Classe parent
content, classe catégorie
3.69.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Entier Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
Objets de script
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Entier Lecture/écriture
Nom Description Type Accès
3.69.4. Méthodes
Aucun
3.70. issuers
L’objet issuers décrit un ensemble de certificats d’émetteur compatibles avec la signature de données, conformément aux normes de signature W3C XML.
3.70.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.70.2. Classe parent
node class catégorie
98
Objets de script 3
3.70.3. Propriétés
99
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.70.4. Méthodes
Aucun
3.71. items
L’objet items fournit une sélection d’options dans une colonne pour une zone de liste ou une case à cocher.
3.71.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.71.2. Classe parent
node class catégorie
Objets de script
3.71.3. Propriétés
Nom Description Type Accès
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
ref Spécifie une expression de syntaxe de référence définissant le nœud dans le modèle de données auquel le conteneur englobant est associé.
Chaîne Lecture/écriture
save Détermine si les valeurs d’une colonne particulière désignent à la fois les valeurs d’affichage et liées, ou si les données de la colonne désignent les valeurs liées uniquement.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.71.4. Méthodes
Aucun
3.72. keep
L’objet keep décrit les contraintes liées au maintien des sous-formulaires dans une page ou une zone de contenu.
3.72.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.72.2. Classe parent
node class catégorie
100
Objets de script 3
3.72.3. Propriétés
101
Nom Description Type Accès
intact Spécifie les contraintes liées au maintien d’un objet parent dans un état intact dans une zone de contenu ou une page.
Chaîne Lecture/écriture
next Indique les contraintes relatives au maintien d’un objet de formulaire avec le conteneur suivant au sein d’une zone de contenu ou d’une page.
Chaîne Lecture/écriture
previous Indique les contraintes relatives au maintien d’un objet de formulaire avec le conteneur précédent au sein d’une zone de contenu ou d’une page.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.72.4. Méthodes
Aucun
3.73. keyUsage
L’objet keyUsage décrit les paramètres d’utilisation des clés devant être définis pour le certificat de signature. Il est créé avec un caractère utilisé pour représenter chaque type d’utilisation des clés. Les neuf premiers caractères, de la gauche vers la droite, représentent la valeur requise pour ces propriétés : digitalSignature, nonRepudiation, keyEncipherment, dataEnci-pherment, keyAgreement, keyCertSign, crlSign, encipherOnly, decipherOnly. Tout caractère supplémentaire est ignoré.
3.73.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
Objets de script
3.73.2. Classe parent
node class catégorie
3.73.3. Propriétés
Nom Description Type Accès
crlSign Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
dataEncipherment
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
decipherOnly Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
digitalSignature Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
encipherOnly Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
keyAgreement Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
keyCertSign Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
keyEncipherment
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
nonRepudiation Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
Chaîne Lecture/écriture
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.73.4. Méthodes
Aucun
102
Objets de script 3
3.74. layoutPseudoModel
103
L’objet layoutPseudoModel sert à identifier au moyen de requêtes des paramètres connus seulement au stade de la conception du formulaire (afin de connaître, par exemple, la page sur laquelle réside un objet de conception de formulaire, le nombre total de pages, le nombre de pages sur lesquelles s’étend un objet ou encore l’orientation d’un objet de conception de formulaire).
3.74.1. Hiérarchie des objets
Modèle Objets enfant
Modèle Layout Aucun
3.74.2. Classe parent
object, classe catégorie
3.74.3. Propriétés
Nom Description Type Accès
ready Indique si le processus de disposition du formulaire est terminé et si les tâches de script peuvent commencer.
Booléen Lecture
3.74.4. Méthodes
Nom Description Renvoie
absPage Détermine la page du formulaire sur laquelle s’affiche pour la première fois un objet de conception de formulaire donné.
Entier
absPageCount Détermine la quantité de pages du formulaire actuel. Entier
absPageCountInBatch
Détermine la quantité de pages du lot actuel. Entier
absPageInBatch Détermine la page du lot qui contient l’objet de formulaire. Entier
Objets de script
absPageSpan Détermine le nombre de pages utilisé par un objet de formulaire donné. Entier
h Détermine la hauteur d’un objet de conception de formulaire donné. Double
page Détermine le numéro de page où figure l’objet de conception de formulaire donné. Si l’objet occupe plusieurs pages, cette méthode renvoie la première page.
Entier
pageContent Récupère les types d’objet de conception de formulaire à partir d’une page donnée d’un formulaire.
Objet
pageCount Détermine le nombre de pages du formulaire actuel. Entier
pageSpan Détermine le nombre de pages logiques utilisé par un objet de conception de formulaire donné.
Entier
relayout Applique à nouveau les options de disposition au formulaire actif. Vide
relayoutPageArea Remplace la disposition du contenu de l’objet pageArea par une nouvelle disposition.
Vide
sheet Détermine le numéro de la feuille où figure l’objet de formulaire. Entier
sheetCount Détermine le nombre de feuilles dans le formulaire actuel. Entier
sheetCountInBatch Détermine le nombre de feuilles dans le lot actuel. Entier
sheetInBatch Détermine la feuille du lot qui contient l’objet de formulaire. Entier
w Détermine la largeur d’un objet de conception de formulaire donné. Double
x Détermine la coordonnée x d’un objet de conception de formulaire donné par rapport à son objet parent.
Double
y Détermine la coordonnée y d’un objet de conception de formulaire donné par rapport à son objet parent.
Double
Nom Description Renvoie
104
Objets de script 3
3.75. line
105
L’objet line décrit une ligne unique générée sur un formulaire.
3.75.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire edge
3.75.2. Classe parent
node class catégorie
3.75.3. Propriétés
Nom Description Type Accès
hand Décrit la justification d’une ligne ou d’un bord. Chaîne Lecture/écriture
slope Indique l’orientation de la ligne. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.75.4. Méthodes
Aucun
Objets de script
3.76. linear
L’objet linear décrit un remplissage dégradé linéaire sur un formulaire.
3.76.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire colorextras
3.76.2. Classe parent
node class catégorie
3.76.3. Propriétés
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.76.4. Méthodes
Aucun
106
Objets de script 3
3.77. manifest
107
L’objet manifest contient une liste de références à l’ensemble des nœuds inclus dans une signature de document.
Si l’objet manifest est un enfant de l’objet signature, la signature du document protège un ensemble de nœuds et non l’intégralité du formulaire.
3.77.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.77.2. Classe parent
node class catégorie
3.77.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Booléen Lecture/écriture
action Identifie les nœuds de formulaire protégés par une signature de document.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.77.4. Méthodes
Nom Description Renvoie
evaluate Récupère la liste des objets référencée dans l’élément Manifest. Objet
execCalculate Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execInitialize Exécute tous les scripts sur l’événement initialize de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execValidate Exécute tous les scripts sur l’événement validate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
3.78. map
L’objet map spécifie les mappages de données à partir des noms de colonnes d’une source de données.
3.78.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.78.2. Classe parent
node class catégorie
108
Objets de script 3
3.78.3. Propriétés
109
Nom Description Type Accès
bind Spécifie le nom d’un ID de liaison unique selon lequel les colonnes de la source de données spécifiées par la propriété from sont liées.
Chaîne Lecture/écriture
from Spécifie le nom original de la colonne dans la source de données. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.78.4. Méthodes
Aucun
3.79. margin
L’objet margin spécifie des valeurs de marge pour un objet de conception de formulaire.
3.79.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.79.2. Classe parent
node class catégorie
Objets de script
3.79.3. Propriétés
Nom Description Type Accès
bottomInset Indique la taille d’une insertion en bas. Chaîne Lecture/écriture
leftInset Indique la taille d’une insertion à gauche. Chaîne Lecture/écriture
rightInset Indique la taille d’une insertion à droite. Chaîne Lecture/écriture
topInset Mesure représentant la taille d’une insertion en haut. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.79.4. Méthodes
Aucun
3.80. mdp
L’objet mdp prend en charge les signatures numériques MDP+ (Modify Detection Prevention Plus). Acrobat 8.0 et les versions ultérieures prennent en charge les signatures numériques MDP+ pour les formulaires XFA.
Dans Designer, les signatures MDP+ sont implémentées avec un champ de signature. Les champs de signature permettent de spécifier une collection d’objets de formulaire protégés par la signature de document. L’utilisation de signatures de document empêche toute modification du formulaire ou d’une partie de celui-ci.
3.80.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.80.2. Classe parent
node class catégorie
110
Objets de script 3
3.80.3. Propriétés
111
Nom Description Type Accès
permissions Spécifie les droits d’accès accordés pour un formulaire qui inclut la signature de l’auteur.
Chaîne Lecture/écriture
signatureType Indique le mode d’enregistrement d’un formulaire comportant une signature du document comme document PDF certifié.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.80.4. Méthodes
Aucun
3.81. medium
L’objet medium décrit un support physique sur lequel effectuer des rendus.
3.81.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.81.2. Classe parent
node class catégorie
Objets de script
3.81.3. Propriétés
Nom Description Type Accès
imagingBBox Spécifie une région sur le support où le rendu peut être effectué à l’aide de quatre mesures séparées par des virgules correspondant aux axes x et y, à la largeur et à la hauteur.
Chaîne Lecture/écriture
long Spécifie la longueur du bord long du support. La longueur spécifiée par la propriété long doit être supérieure à celle spécifiée par la propriété short.
Chaîne Lecture/écriture
orientation Indique l’orientation du support. Chaîne Lecture/écriture
short Spécifie la longueur du bord court de l’objet. Chaîne Lecture/écriture
stock Spécifie le nom d’un format de papier standard. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.81.4. Méthodes
Aucun
3.82. message
L’objet message contient un ou plusieurs sous-objets générant des messages d’échec de validation.
3.82.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire text
112
Objets de script 3
3.82.2. Classe parent
113
node class catégorie
3.82.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.82.4. Méthodes
Aucun
3.83. numericEdit
L’objet numericEdit décrit une commande destinée à faciliter la manipulation des contenus numériques.
3.83.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire bordercombextrasmargin
3.83.2. Classe parent
node class catégorie
Objets de script
3.83.3. Propriétés
Nom Description Type Accès
hScrollPolicy Indique si un champ peut défiler horizontalement. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.83.4. Méthodes
Aucun
3.84. occur
L’objet occur décrit les contraintes liées au nombre d’instances autorisé pour son conteneur englobant.
Modifiez l’objet occur sur l’événement template:ready. Toutefois, l’événement template:ready n’est pas accessible dans l’interface utilisateur. Vous ne pouvez pas modifier l’objet occur sur l’événement form:ready, car ce dernier survient trop tard dans le traitement du formulaire.
3.84.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extrasscript (occur.scriptest réservé pour une utilisation ultérieure)
3.84.2. Classe parent
node class catégorie
114
Objets de script 3
3.84.3. Propriétés
115
Nom Description Type Accès
initial Spécifie le nombre initial d’occurrences pour un sous-formulaire ou un jeu de sous-formulaires. Cette propriété doit être utilisée uniquement pour les formulaires imprimés et statiques.
Chaîne Lecture
max Indique le nombre maximal d’occurrences pour le conteneur qui englobe ou -1 pour ne définir aucune limite supérieure pour les occurrences.
Chaîne Lecture/écriture
min Indique le nombre minimal d’occurrences du conteneur englobant. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.84.4. Méthodes
Aucun
3.85. oid
L’objet oid décrit un identifiant d’objet (OID) des stratégies de certificats devant apparaître dans la signature du certificat.
3.85.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.85.2. Classe parent
textNode, classe catégorie
Objets de script
3.85.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.85.4. Méthodes
Aucun
3.86. oids
L’objet oids décrit un ensemble d’identifiants d’objets (OID) qui s’appliquent à la signature de données, conformément aux normes W3C XML.
Cet objet n’est valide que s’il est apparenté à un objet issuers qui n’est pas vide.
3.86.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.86.2. Classe parent
node class catégorie
116
Objets de script 3
3.86.3. Propriétés
117
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.86.4. Méthodes
Aucun
3.87. operation
L’objet operation représente une opération spécifique fournie par une adresse WSDL spécifique. Chaque opération correspond à une connexion de données unique.
3.87.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet Aucun
3.87.2. Classe parent
textNode, classe catégorie
Objets de script
3.87.3. Propriétés
Nom Description Type Accès
input Spécifie un message d’entrée associé à une opération de connexion WSDL particulière.
Chaîne Lecture/écriture
output Spécifie le message de sortie associé à une opération de connexion WSDL particulière.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.87.4. Méthodes
Aucun
3.88. overflow
L’objet overflow stocke des propriétés utilisées lorsqu’un objet subform parent déborde sur l’objet actuel contentArea.
3.88.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.88.2. Classe parent
node class catégorie
118
Objets de script 3
3.88.3. Propriétés
119
Nom Description Type Accès
leader Indique l’objet subform ou subformSet devant être placé en haut d’une zone de contenu ou d’une zone de page.
Chaîne Lecture/écriture
target Indique l’objet sur lequel l’action se produit. Chaîne Lecture/écriture
trailer Indique l’objet subform ou subformSet devant être placé en bas d’une zone de contenu ou d’une zone de page.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.88.4. Méthodes
Aucun
3.89. packet
L’objet packet stocke des objets non reconnus, c’est-à-dire ceux qui ne se conforment à aucun des autres modèles d’objet de formulaire XML. Cet objet permet de copier, déplacer ou récupérer les informations dans ces objets non reconnus.
3.89.1. Hiérarchie des objets
Modèle Objets enfant
Modèle XFA Aucun
3.89.2. Classe parent
node class catégorie
Objets de script
3.89.3. Propriétés
Nom Description Type Accès
content Indique le contenu de l’objet. Chaîne Lecture/écriture
3.89.4. Méthodes
Nom Description Renvoie
getAttribute Récupère une valeur de propriété spécifiée. Chaîne
removeAttribute Supprime un attribut XML dans un paquet XML tiers personnalisé ajouté à la source XML d’une conception de formulaire.
Vide
setAttribute Définit la valeur d’une propriété spécifiée. Vide
3.90. pageArea
L’objet pageArea décrit une surface de rendu.
3.90.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire descextrasmediumoccur
3.90.2. Classe parent
container, classe
120
Objets de script 3
3.90.3. Propriétés
121
Nom Description Type Accès
blankOrNotBlank
Spécifie si la zone de page doit être vierge et par conséquent faire l’objet d’un traitement particulier par le périphérique de sortie.
Chaîne Lecture/écriture
initialNumber Fournit le numéro de page d’origine pour la première page d’un groupe de pages consécutives qui utilisent le même objet pageSet.
Chaîne Lecture/écriture
numbered Spécifie si la zone de page est assimilée à une zone de page numérotée.
Chaîne Lecture/écriture
oddOrEven Indique si une page est paire ou impaire pour la pagination d’un jeu de pages.
Chaîne Lecture/écriture
pagePosition Indique une position de la page dans un jeu de pages. Chaîne Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.90.4. Méthodes
Aucun
3.91. pageSet
L’objet pageSet décrit un jeu d’objets de zones de pages associés.
3.91.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extrasoccur
Objets de script
3.91.2. Classe parent
container, classe
3.91.3. Propriétés
Nom Description Type Accès
duplexImposition Contrôle l’orientation de l’image de la page lors de l’impression des deux côtés.
Chaîne Lecture/écriture
relation Indique les rapports qu’entretiennent les membres du jeu. Chaîne Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.91.4. Méthodes
Aucun
3.92. para
L’objet para spécifie les propriétés de paragraphe et d’alignement par défaut à appliquer au contenu d’un conteneur englobant.
3.92.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire hyphenation
122
Objets de script 3
3.92.2. Classe parent
123
node class catégorie
3.92.3. Propriétés
Nom Description Type Accès
hAlign Indique l’alignement de texte horizontal. Chaîne Lecture/écriture
lineHeight Indique la hauteur de ligne à appliquer au contenu d’un paragraphe. Chaîne Lecture/écriture
marginLeft Indique la taille du retrait d’un paragraphe à gauche. Chaîne Lecture/écriture
marginRight Indique la taille du retrait d’un paragraphe à droite. Chaîne Lecture/écriture
preserve Spécifie les contraintes veuve/orphelin associées au comportement de débordement du contenu au sein du conteneur qui englobe.
Chaîne Lecture/écriture
radixOffset Spécifie une valeur de décalage pour le point d’ancrage du paragraphe. Chaîne Lecture/écriture
spaceAbove Indique la quantité d’espacement vertical et la taille maximale de police sur la première ligne d’un paragraphe.
Chaîne Lecture/écriture
spaceBelow Indique la quantité d’espacement vertical et la taille maximale de police sur la première ligne d’un paragraphe.
Chaîne Lecture/écriture
tabDefault Spécifie la distance entre les taquets de tabulation par défaut. Chaîne Lecture/écriture
tabStops Spécifie une liste d’emplacements de taquets de tabulation et de propriétés de filet de conduite séparés par des espaces.
Chaîne Lecture/écriture
textIndent Indique la position horizontale de la première ligne par rapport au reste d’un paragraphe.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
vAlign Indique l’alignement de texte vertical. Chaîne Lecture/écriture
Objets de script
wordSpacingMaximum
Définit l’espace intermots maximum (en pourcentage) lorsque le texte est justifié et/ou si la césure est activée.
Chaîne Lecture/écriture
wordSpacingMinimum
Définit l’espace intermots minimum (en pourcentage) lorsque le texte est justifié et/ou si la césure est activée.
Chaîne Lecture/écriture
wordSpacingOptimum
Définit l’espace intermots optimal (en pourcentage) lorsque le texte est justifié et/ou si la césure est activée.
Chaîne Lecture/écriture
Nom Description Type Accès
3.92.4. Méthodes
Aucun
3.93. password
L’objet password spécifie le mot de passe pour la source de données (si la connexion l’exige).
3.93.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.93.2. Classe parent
textNode, classe catégorie
3.93.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
124
Objets de script 3
3.93.4. Méthodes
125
Aucun
3.94. passwordEdit
L’objet passwordEdit décrit une commande destinée à faciliter la manipulation des contenus de mots de passe. L’interface utilisateur masque toute représentation visuelle du contenu.
3.94.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire borderextrasmargin
3.94.2. Classe parent
node class catégorie
3.94.3. Propriétés
Nom Description Type Accès
hScrollPolicy Indique si un champ peut défiler horizontalement. Chaîne Lecture/écriture
passwordChar Indique le caractère visible à l’écran lorsqu’un utilisateur saisit un mot de passe dans le formulaire.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.94.4. Méthodes
Aucun
3.95. pattern
L’objet pattern décrit un modèle de remplissage pour un objet de conception de formulaire.
3.95.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire colorextras
3.95.2. Classe parent
node class catégorie
3.95.3. Propriétés
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.95.4. Méthodes
Aucun
126
Objets de script 3
3.96. picture
127
L’objet picture présente des informations relatives aux masques de saisie et au formatage des valeurs de sortie.
3.96.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.96.2. Classe parent
node class catégorie
3.96.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.96.4. Méthodes
Aucun
Objets de script
3.97. proto (désapprouvé)
L’objet proto décrit un jeu de définitions d’objets réutilisables.
3.97.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.97.2. Classe parent
Aucun
3.97.3. Propriétés
Aucun
3.97.4. Méthodes
Aucun
3.98. query
L’objet query représente une requête effectuée sur une source de données particulière.
3.98.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet recordSetselect
128
Objets de script 3
3.98.2. Classe parent
129
node class catégorie
3.98.3. Propriétés
Nom Description Type Accès
commandType Spécifie le type de commande utilisé par une requête de données.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.98.4. Méthodes
Aucun
3.99. radial
L’objet radial décrit un remplissage dégradé radial.
3.99.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire colorextras
3.99.2. Classe parent
node class catégorie
Objets de script
3.99.3. Propriétés
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.99.4. Méthodes
Aucun
3.100. reason
L’objet reason contient une raison justifiant la signature de données, conformément aux normes W3C XML.
3.100.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.100.2. Classe parent
textNode, classe catégorie
130
Objets de script 3
3.100.3. Propriétés
131
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.100.4. Méthodes
Aucun
3.101. reasons
L’objet reasons contient des raisons justifiant la signature de données, conformément aux normes W3C XML.
3.101.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.101.2. Classe parent
node class catégorie
Objets de script
3.101.3. Propriétés
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.101.4. Méthodes
Aucun
3.102. recordSet
L’objet recordSet contient plusieurs enregistrements basés sur une requête particulière de la source de données. Ces enregistrements peuvent être affichés, réorganisés, ajoutés et supprimés.
3.102.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.102.2. Classe parent
node class catégorie
132
Objets de script 3
3.102.3. Propriétés
133
Nom Description Type Accès
bofAction Spécifie l’opération à effectuer si l’enregistrement actif est le premier du jeu d’enregistrements.
Chaîne Lecture/écriture
cursorLocation Indique l’emplacement de la bibliothèque de curseurs à utiliser avec le jeu d’enregistrements.
Chaîne Lecture/écriture
cursorType Spécifie le type de curseur à utiliser à l’ouverture du jeu d’enregistrements.
Chaîne Lecture/écriture
eofAction Spécifie l’opération à effectuer si l’enregistrement actif est le dernier du jeu d’enregistrements.
Chaîne Lecture/écriture
lockType Indique le type de fonction de verrouillage à utiliser avec la source de données.
Chaîne Lecture/écriture
max Indique le nombre maximal d’occurrences pour le conteneur qui englobe ou -1 pour ne définir aucune limite supérieure pour les occurrences.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.102.4. Méthodes
Aucun
Objets de script
3.103. rectangle
L’objet rectangle décrit un rectangle généré unique.
3.103.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire corneredgefill
3.103.2. Classe parent
node class catégorie
3.103.3. Propriétés
Nom Description Type Accès
hand Décrit la justification d’une ligne ou d’un bord. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.103.4. Méthodes
Aucun
134
Objets de script 3
3.104. ref
135
L’objet ref contient une expression de syntaxe de référence qui identifie un nœud à inclure dans une signature numérique XML.
3.104.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.104.2. Classe parent
textNode, classe catégorie
3.104.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.104.4. Méthodes
Aucun
Objets de script
3.105. rootElement
L’objet rootElement spécifie l’élément XML au sein d’une connexion aux données du schéma XML à utiliser comme racine d’un fichier de données à l’intérieur du formulaire.
3.105.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet Aucun
3.105.2. Classe parent
textNode, classe catégorie
3.105.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.105.4. Méthodes
Aucun
136
Objets de script 3
3.106. script
137
L’objet script contient un script écrit en FormCalc ou en JavaScript.
3.106.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.106.2. Classe parent
node class catégorie
3.106.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
binding Identifie le type d’application auquel s’adresse le script. Chaîne Lecture/écriture
contentType Spécifie le type de contenu présent dans le document référencé, à savoir MIME.
Chaîne Lecture/écriture
runAt Indique quelle application peut exécuter le script. Chaîne Lecture/écriture
stateless Détermine si les variables d’un script sont conservées d’une invocation à l’autre.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
Objets de script
3.106.4. Méthodes
Aucun
3.107. select
L’objet select renferme les informations de sélection de requête d’instruction à utiliser avec la source de données en cours.
3.107.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.107.2. Classe parent
textNode, classe catégorie
3.107.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.107.4. Méthodes
Aucun
138
Objets de script 3
3.108. setProperty
139
L’objet setProperty modifie une propriété de son objet parent. Un objet parent peut contenir un nombre illimité d’objets setProperty.
L’objet target est une expression de syntaxe de référence qui décrit une propriété unique de l’objet parent. Cette propriété identifie le nœud dont la valeur doit être identique à celle identifiée par l’objet ref et la propriété connection. Par exemple, la cible spécifiée pour définir l’objet toolTip d’un champ estaccess.toolTip.
Dans le conteneur parent, il n’existe pas de restrictions sur le type de propriétés pouvant être ciblées par l’objet setProperty. Toutefois, l’événement setProperty ne peut pas cibler les propriétés de conteneurs imbriqués.
L’application de l’objet setProperty est une opération de modèle. La référence est résolue et la valeur de données est appliquée à la propriété target lors de la création du formulaire suite à une fusion. Il n’existe pas de liaison permanente entre le nœud de données et la propriété. Tous les changements ultérieurs effectués sur les données ne sont pas propagés à la propriété target sauf en cas de nouvelle fusion.
REMARQUE : L’utilisation de l’objet setProperty pour cibler les propriétés connexes de liaison, telles que l’objet bind ou #name est probablement inutile, car l’application de setProperty survient après le processus de fusion.
3.108.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire ref
3.108.2. Classe parent
node class catégorie
3.108.3. Propriétés
Nom Description Type Accès
connection Spécifie le nom du contrôle de connexion associé dans l’ensemble de connexions.
Chaîne Lecture/écriture
target Indique l’objet sur lequel l’action se produit. Chaîne Lecture/écriture
Objets de script
3.108.4. Méthodes
Aucun
3.109. signature
L’objet signature détermine quels autres objets sont signés par une signature.
3.109.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire borderextrasfiltermanifestmargin
3.109.2. Classe parent
node class catégorie
3.109.3. Propriétés
Nom Description Type Accès
type (signature.typeest réservé pour une utilisation ultérieure)
Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.109.4. Méthodes
Aucun
140
Objets de script 3
3.110. signatureProperties (désapprouvé)
141
L’objet signatureProperties contient les propriétés d’une signature de données XML. Les objets insérés dans cet objet sont insérés dans la signature XML en tant que données XMP.
3.110.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.110.2. Classe parent
node class catégorie
3.110.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.110.4. Méthodes
Aucun
Objets de script
3.111. signaturePseudoModel
L’objet signaturePseudoModel constitue l’objet racine du modèle de signature.
3.111.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de signature Aucun
3.111.2. Classe parent
object, classe catégorie
3.111.3. Méthodes
Nom Description Renvoie
clear Supprime une signature donnée. Booléen
enumerate Enumère toutes les signatures XML trouvées dans le document. Objet
sign Appose une signature à une liste de nœuds donnée et place la signature à l’emplacement cible.
Booléen
verify Authentifie la signature. Entier
142
Objets de script 3
3.112. signData
143
L’objet signData contrôle la création d’une signature de données conformément aux normes W3C XML.
3.112.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire filtermanifestref
3.112.2. Classe parent
node class catégorie
3.112.3. Propriétés
Nom Description Type Accès
operation Indique l’opération de signature numérique à effectuer en cas d’utilisation conjointe avec l’objet signData ou l’objet avec lequel créer un lien en cas d’utilisation conjointe avec l’objet traverse.
Chaîne Lecture/écriture
target Indique l’objet sur lequel l’action se produit. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.112.4. Méthodes
Aucun
Objets de script
3.113. signing
L’objet signing décrit une collection de certificats de signature compatibles avec la signature de données, conformément aux normes W3C XML.
3.113.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.113.2. Classe parent
node class catégorie
3.113.3. Propriétés
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.113.4. Méthodes
Aucun
144
Objets de script 3
3.114. soapAction
145
L’objet soapAction contient une action SOAP complète.
3.114.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet Aucun
3.114.2. Classe parent
textNode, classe catégorie
3.114.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.114.4. Méthodes
Aucun
Objets de script
3.115. soapAddress
L’objet soapAddress stocke l’emplacement complet du point final SOAP. Cet emplacement doit être défini au format standard RFC2396.
3.115.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet Aucun
3.115.2. Classe parent
textNode, classe catégorie
3.115.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.115.4. Méthodes
Aucun
146
Objets de script 3
3.116. solid
147
L’objet solid décrit un style de remplissage plein attribué à un objet de conception de formulaire.
3.116.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.116.2. Classe parent
node class catégorie
3.116.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.116.4. Méthodes
Aucun
Objets de script
3.117. source
L’objet source représente une source de données externe.
3.117.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet connect
3.117.2. Classe parent
node class catégorie
3.117.3. Propriétés
Nom Description Type Accès
db Spécifie la technologie utilisée pour communiquer avec une base de données.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.117.4. Méthodes
Nom Description Renvoie
addNew Ajoute un nouvel enregistrement au jeu d’enregistrements. Vide
cancel Annule toutes modifications apportées à la rangée active ou à une nouvelle rangée de l’objet de jeu d’enregistrements ou à la collection de champs d’un objet d’enregistrement, avant l’appel de la méthode update .
Vide
cancelBatch Annule une mise à jour par lots en attente Vide
148
Objets de script 3
149
close Ferme une connexion à une source de données. Vide
delete (FormCalc uniquement)
Supprime l’enregistrement actuel du jeu d’enregistrements. Vide
deleteRecord Supprime l’enregistrement actuel du jeu d’enregistrements. Vide
first Accède au premier enregistrement dans le jeu d’enregistrements et remplit le modèle de données avec les données d’enregistrement.
Vide
hasDataChanged Détermine si les données de l’enregistrement actuel ont été modifiées. Booléen
isBOF Détermine si l’emplacement actuel se trouve au début du jeu d’enregistrements. L’objet bofAction doit être définie sur stayBOF.
Booléen
isEOF Détermine si l’emplacement actuel se trouve à la fin du jeu d’enregistrements. La propriété eofAction doit être définie sur stayEOF.
Booléen
last Accède au dernier enregistrement dans le jeu d’enregistrements et remplit le modèle de données avec les données d’enregistrement.
Vide
next Accède à l’enregistrement suivant dans le jeu d’enregistrements et remplit le modèle de données avec les données d’enregistrement.
Vide
open Etablit la connexion à la source de données et remplit le modèle de données avec les résultats de l’enregistrement actuel.
Vide
previous Accède à l’enregistrement précédent dans le jeu d’enregistrements et remplit le modèle de données avec les données d’enregistrement.
Vide
requery Met à jour la liaison active des données en exécutant à nouveau la requête sur laquelle reposent les données d’objet. L’appel de cette méthode équivaut à appeler les méthodes close et open l’une après l’autre.
Vide
resync Actualise le jeu d’enregistrements ou la connexion aux données actif. Vide
update Met à jour l’enregistrement actif dans le jeu d’enregistrements. Vide
updateBatch Ecrit toutes les mises à jour du lot en attente dans la source de données. Vide
Nom Description Renvoie
Objets de script
3.118. sourceSet
La propriété sourceSet constitue l’objet racine du modèle sourceSet.
3.118.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet source
3.118.2. Classe parent
model, classe catégorie
3.118.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.118.4. Méthodes
Aucun
150
Objets de script 3
3.119. speak
151
La propriété speak diffuse une invite sonore décrivant le contenu d’un objet de conteneur, tel qu’un champ ou un sous-formulaire. Cet objet n’est pas pris en compte par les applications de formulaire non interactives.
3.119.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.119.2. Classe parent
textNode, classe catégorie
3.119.3. Propriétés
Nom Description Type Accès
disable Désactive l’invite audible. Chaîne Lecture/écriture
priority Modifie le chemin de recherche du texte lu. L’objet spécifié dans cette propriété passe au début du chemin de recherche. Les autres objets conservent leur ordre relatif.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.119.4. Méthodes
Aucun
Objets de script
3.120. stipple
La propriété stipple décrit un effet grisé appliqué à un objet de formulaire.
3.120.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire colorextras
3.120.2. Classe parent
node class catégorie
3.120.3. Propriétés
Nom Description Type Accès
rate Spécifie le pourcentage de motif grisé sur un arrière-plan plein. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.120.4. Méthodes
Aucun
152
Objets de script 3
3.121. subform
153
La propriété subform décrit un sous-formulaire unique pouvant englober d’autres conteneurs.
En termes d’objets disponibles dans la Bibliothèque d’objets de Designer, l’objet de champ est la définition XML de base pour les objets suivants :
• Sous-formulaire
• Tableau (y compris les rangées de contenu, les rangées d’en-tête et les rangées de pied de page)
3.121.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire
assistbindbookendborderbreak (désapprouvé)breakAfterbreakBeforecalculateconnectdesceventexObject
extrasinstanceManagerkeepmarginoccuroverflowparasetPropertytraversalvalidatevariable
3.121.2. Classe parent
container, classe
3.121.3. Propriétés
Nom Description Type Accès
access Définit l’accès de l’utilisateur au contenu d’un objet conteneur, tel qu’un sous-formulaire.
Chaîne Lecture/écriture
allowMacro Spécifie si l’application de traitement est autorisée ou non à optimiser les résultats en créant une macro d’imprimante pour tout le contenu de dessin du sous-formulaire.
Chaîne Lecture/écriture
Objets de script
anchorType Indique l’emplacement du point d’ancrage du conteneur lors de l’utilisation d’une stratégie de disposition positionnée.
Chaîne Lecture/écriture
borderColor Indique la valeur de la couleur de la bordure pour ce champ. Chaîne Lecture/écriture
borderWidth Indique la largeur de la bordure pour ce champ. Chaîne Lecture/écriture
colSpan Spécifie le nombre de colonnes étendues par cet objet lorsqu’il est incorporé dans un sous-formulaire doté d’un type de disposition des rangées particulier.
Chaîne Lecture/écriture
columnWidths Spécifie la largeur des colonnes d’un tableau. Chaîne Lecture/écriture
fillColor Valeur de la couleur d’arrière-plan pour ce champ. Chaîne Lecture/écriture
h Mesure de la hauteur pour la disposition. Chaîne Lecture/écriture
hAlign Indique l’alignement de texte horizontal. Chaîne Lecture/écriture
instanceIndex Calcule l’index d’un sous-formulaire ou jeu de sous-formulaires en fonction de son emplacement par rapport à d’autres instances du même objet de formulaire.
Entier Lecture/écriture
layout Indique la stratégie de disposition utilisée par cet objet. Chaîne Lecture/écriture
locale Indique la langue, la devise et le format de date/heure à utiliser pour le contenu de l’objet.
Chaîne Lecture/écriture
maxH Indique la hauteur maximale à des fins de disposition. Chaîne Lecture/écriture
maxW Indique la largeur maximale à des fins de disposition. Chaîne Lecture/écriture
mergeMode Commandes dont l’algorithme de fusion de données est utilisé pour un sous-formulaire donné.
Chaîne Lecture/écriture
minH Indique la hauteur maximale à des fins de disposition. Chaîne Lecture/écriture
minW Indique la largeur maximale à des fins de disposition. Chaîne Lecture/écriture
Nom Description Type Accès
154
Objets de script 3
155
presence Indique si un objet est visible ou non. Chaîne Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
restoreState Rétablit les nœuds de formulaire d’un formulaire à leur état d’origine, tout en réinitialisant les propriétés visuelles des champs, telles que les modifications apportées aux couleurs des bordures.
Chaîne Lecture/écriture
scope Contrôle l’intervention du sous-formulaire dans la liaison de données et les expressions de syntaxe de référence. Valide uniquement sur le sous-formulaire racine.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
validationMessage
Indique la chaîne de message de validation pour ce champ. Chaîne Lecture/écriture
vAlign Indique l’alignement de texte vertical. Chaîne Lecture/écriture
w Mesure indiquant la largeur pour la disposition. Chaîne Lecture/écriture
x Indique la coordonnée X du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
y Indique la coordonnée Y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Chaîne Lecture/écriture
Nom Description Type Accès
Objets de script
3.121.4. Méthodes
Nom Description Renvoie
execCalculate Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execEvent Exécute le script d’événement de l’objet. Vide
execInitialize Exécute tous les scripts sur l’événement initialize de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execValidate Exécute tous les scripts sur l’événement validate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
getInvalidObjects Renvoie une liste de nœuds contenus dans ce sous-formulaire (inclus) qui ont échoué au test de validation.
Vide
3.122. subformSet
L’objet subformSet décrit un jeu d’objets de sous-formulaires associés.
3.122.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire bookendbreak (désapprouvée)descextrasinstanceManageroccuroverflow
3.122.2. Classe parent
container, classe
156
Objets de script 3
3.122.3. Propriétés
157
Nom Description Type Accès
instanceIndex Calcule l’index d’un sous-formulaire ou jeu de sous-formulaires en fonction de son emplacement par rapport à d’autres instances du même objet de formulaire.
Entier Lecture/écriture
relation Indique les rapports qu’entretiennent les membres du jeu. Chaîne Lecture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.122.4. Méthodes
Aucun
3.123. subjectDN
L’objet subnectDN décrit les attributs pour un pseudo du sujet (PS) qui doit être présent au sein du certificat de signature afin qu’il soit compatible avec la signature. Il s’agit d’un réseau de dictionnaires, où chaque dictionnaire contient des paires identifiant-valeur qui spécifient le pseudo sujet (PS). Le certificat doit contenir tous les attributs spécifiés dans le dictionnaire, mais il peut contenir des attributs supplémentaires. La clé peut être n’importe quel identifiant d’attribut légal.
Pour plus d’informations sur les attributs Pseudo et leurs types, voir le document RFC 3280.
3.123.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
Objets de script
3.123.2. Classe parent
node class catégorie
3.123.3. Propriétés
Nom Description Type Accès
delimiter Sépare les attributs dans la chaîne Pseudo PS. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.123.4. Méthodes
Aucun
3.124. subjectDNs
L’objet subjectDNs décrit l’ensemble de paires identifiant-valeur utilisées pour spécifier le pseudo sujet (PS).
3.124.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire subjectDN
3.124.2. Classe parent
node class catégorie
158
Objets de script 3
3.124.3. Propriétés
159
Nom Description Type Accès
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.124.4. Méthodes
Aucun
3.125. submit
L’objet submit décrit comment envoyer des données à un hôte.
3.125.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire encrypt
3.125.2. Classe parent
node class catégorie
Objets de script
3.125.3. Propriétés
Nom Description Type Accès
embedPDF Détermine si le fichier PDF doit être inclus aux données. Chaîne Lecture/écriture
format Détermine le format à utiliser pour envoyer les données. Chaîne Lecture/écriture
target Indique l’objet sur lequel l’action se produit. Chaîne Lecture/écriture
textEncoding Indique le codage du contenu de texte dans un document. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
xdpContent Définit le sous-ensemble de données qui est envoyé. Cette propriété est utilisée uniquement lorsque la propriété format est xdp.
Chaîne Lecture/écriture
3.125.4. Méthodes
Aucun
3.126. template
L’objet template décrit un modèle. Un objet de ce type existe pour chaque modèle et tous les autres objets qui sont des descendants de l’objet de modèle.
3.126.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
160
Objets de script 3
3.126.2. Classe parent
161
model, classe catégorie
3.126.3. Propriétés
Aucun.
3.126.4. Méthodes
Nom Description Renvoie
createNode Crée un nouveau nœud en fonction d’un nom de classe correct. Objet
execCalculate Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execInitialize Exécute tous les scripts sur l’événement initialize de l’objet spécifié, ainsi que tous les objets enfants.
Vide
execValidate Exécute tous les scripts sur l’événement validate de l’objet spécifié, ainsi que tous les objets enfants.
Vide
formNodes Renvoie la liste de tous les objets de modèle du formulaire liés à un objet de données spécifié.
Objet
metadata Collecte un paquet de métadonnées XMP (Extensible Metadata Platform) complet pour le document.
Chaîne
recalculate Force l’exécution d’un jeu spécifique de scripts sur des événements de calculs. Les événements spécifiques peuvent être des événements de calculs en attente ou l’intégralité des événements de calculs.
Vide
remerge Force la fusion des modèles de données et la conception de modèle pour recréer un modèle de formulaire. Une fois la fusion effectuée, tout traitement de modèle de disposition doit être à nouveau effectué pour déterminer le formulaire.
Vide
Objets de script
3.127. text
L’objet text décrit une unité de contenu unique représentant une valeur de texte brut.
3.127.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaireModèle sourceSet
Aucun
3.127.2. Classe parent
content, classe catégorie
3.127.3. Propriétés
3.127.4. Méthodes
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
maxChars Indique le nombre maximal de caractères que cette valeur de texte peut englober.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
Aucun
162
Objets de script 3
3.128. textEdit
163
L’objet textEdit renferme des commandes destinées à faciliter la manipulation des contenus de texte.
3.128.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire bordercomb (textEdit.combest réservé pour une utilisation ultérieure)extrasmargin
3.128.2. Classe parent
node class catégorie
3.128.3. Propriétés
Nom Description Type Accès
allowRichText
Indique si le texte est compatible avec les styles (ce qu’on appelle également du texte enrichi).
Chaîne Lecture/écriture
hScrollPolicy
Indique si un champ peut défiler horizontalement. Chaîne Lecture/écriture
multiLine Indique si le texte peut couvrir plusieurs lignes. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
vScrollPolicy Indique si un champ peut défiler verticalement. Chaîne Lecture/écriture
3.128.4. Méthodes
Aucun
Objets de script
3.129. time
L’objet time décrit une unité de données représentant une valeur temporelle.
3.129.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.129.2. Classe parent
content, classe catégorie
3.129.3. Propriétés
Nom Description Type Accès
{default} Représente la valeur réelle stockée par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
value Indique la valeur de l’objet actuel. Chaîne Lecture/écriture
3.129.4. Méthodes
Aucun
164
Objets de script 3
3.130. timeStamp
165
L’objet timeStamp ajoute un tampon temporel à une signature de document. Un tampon temporel spécifie la date et l’heure de signature d’un document, ce qui permet de savoir avec certitude à quel moment le document a été signé.
3.130.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.130.2. Classe parent
node class catégorie
3.130.3. Propriétés
Nom Description Type Accès
server Indique l’URL pour un serveur de tampons temporels. Chaîne Lecture/écriture
type Spécifie le modèle utilisé par un objet. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.130.4. Méthodes
Aucun
Objets de script
3.131. toolTip
L’objet toolTip fournit du texte pour une info-bulle sur un formulaire. Cet objet n’est pas pris en compte par les applications de formulaire non interactives.
3.131.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire Aucun
3.131.2. Classe parent
textNode, classe catégorie
3.131.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.131.4. Méthodes
Aucun
166
Objets de script 3
3.132. traversal
167
L’objet traversal lie son conteneur à d’autres objets dans une séquence.
3.132.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extras
3.132.2. Classe parent
node class catégorie
3.132.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.132.4. Méthodes
Aucun
Objets de script
3.133. traverse
L’objet traverse déclare un lien unique entre son conteneur et un autre objet dans une chaîne de liens unidirectionnelle.
3.133.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extrasscript
3.133.2. Classe parent
node class catégorie
3.133.3. Propriétés
Nom Description Type Accès
operation Indique l’opération de signature numérique à effectuer en cas d’utilisation conjointe avec l’objet signData ou l’objet avec lequel créer un lien en cas d’utilisation conjointe avec l’objet traverse.
Chaîne Lecture/écriture
ref Spécifie une expression de syntaxe de référence définissant le nœud dans le modèle de données auquel le conteneur englobant est associé.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.133.4. Méthodes
Aucun
168
Objets de script 3
3.134. ui
169
L’objet ui renferme la description d’interface utilisateur d’un objet de formulaire.
3.134.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extraspicture
3.134.2. Classe parent
node class catégorie
3.134.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.134.4. Méthodes
Aucun
Objets de script
3.135. update
L’objet update spécifie l’opération de mise à jour de l’enregistrement en cours de la source de données.
3.135.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.135.2. Classe parent
textNode, classe catégorie
3.135.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.135.4. Méthodes
Aucun
170
Objets de script 3
3.136. uri
171
L’objet uri stocke une URI complète pour un objet xmlConnection ou xsdConnection.
3.136.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet Aucun
3.136.2. Classe parent
textNode, classe catégorie
3.136.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.136.4. Méthodes
Aucun
Objets de script
3.137. user
L’objet user spécifie l’ID utilisateur pour la source de données (si la connexion l’exige).
3.137.1. Hiérarchie des objets
Modèle Objets enfant
Modèle sourceSet Aucun
3.137.2. Classe parent
textNode, classe catégorie
3.137.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.137.4. Méthodes
Aucun
172
Objets de script 3
3.138. validate
173
L’objet validate contrôle la validation de données fournies par l’utilisateur sur un formulaire.
L’objet validate peut être activé plusieurs fois pendant la durée de vie d’un formulaire.
3.138.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire extrasmessagepicturescript
3.138.2. Classe parent
node class catégorie
3.138.3. Propriétés
Nom Description Type Accès
disableAll Active ou désactive les avertissements en matière de validation. Chaîne Lecture/écriture
formatTest Définit la validation d’une clause d’image. Chaîne Lecture/écriture
nullTest Détermine si un champ est obligatoire dans un formulaire ou s’il peut être laissé vide.
Chaîne Lecture/écriture
scriptTest Contrôle la validation effectuée par le script inclus. Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
Objets de script
3.138.4. Méthodes
Aucun
3.139. value
L’objet value renferme une unité de contenu unique.
3.139.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.139.2. Classe parent
node class catégorie
3.139.3. Propriétés
Nom Description Type Accès
override Lorsqu’elle est utilisée avec l’objet calculate , la propriété override indique si le champ autorise les remplacements et désactive ou active les calculs. Utilisée avec l’objet value, la propriété override indique si un remplacement des calculs a eu lieu.
Booléen Lecture/écriture
relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
Chaîne Lecture/écriture
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
174
Objets de script 3
3.139.4. Méthodes
175
Aucun
3.140. variable
L’objet variable est utilisé pour stocker des variables de document.
3.140.1. Hiérarchie des objets
Modèle Objets enfant
Modèle de formulaire none
3.140.2. Classe parent
container, classe
3.140.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.140.4. Méthodes
Aucun
Objets de script
3.141. wsdlAddress
L’objet wsdlAddress contient l’URL originale du fichier WSDL référencé dans l’objet wsdlConnection.
3.141.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet Aucun
3.141.2. Classe parent
textNode, classe catégorie
3.141.3. Propriétés
Nom Description Type Accès
use Appelle un prototype. Chaîne Lecture/écriture
usehref Appelle un prototype externe. Chaîne Lecture/écriture
3.141.4. Méthodes
Aucun
176
Objets de script 3
3.142. wsdlConnection
177
L’objet wsdlConnection identifie une connexion unique aux services Web WSDL.
3.142.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet effectiveInputPolicyeffectiveOutputPolicyoperationsoapActionsoapAddresswsdlAddress
3.142.2. Classe parent
node class catégorie
3.142.3. Propriétés
Nom Description Type Accès
dataDescription Spécifie le nom de la description d’une connexion aux données à utiliser avec un type particulier de connexion aux services Web.
Chaîne Lecture/écriture
3.142.4. Méthodes
Nom Description Renvoie
execute Exécute une connexion. Booléen
Objets de script
3.143. xfa
L’objet xfa constitue le nœud racine pour le modèle xfa.
3.143.1. Hiérarchie des objets
Modèle Objets enfant
Modèle XFA packet
3.143.2. Classe parent
model, classe catégorie
3.143.3. Propriétés
Aucun
Nom Description Type Accès
this Récupère le nœud actif, qui est le nœud de départ lors de l’utilisation des méthodes resolveNode et resolveNodes.
Objet Lecture
timeStamp Indique le tampon de date et d’heure pour ce nœud. Chaîne Lecture/écriture
uuid Indique l’identificateur unique universel (UUID) pour cet objet. Chaîne Lecture/écriture
3.143.4. Méthodes
Aucun
178
Objets de script 3
3.144. xmlConnection
179
L’objet xmlConnection sert à stocker un exemple de connexion aux données XML.
3.144.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet uri
3.144.2. Classe parent
node class catégorie
3.144.3. Propriétés
Nom Description Type Accès
dataDescription Spécifie le nom de la description d’une connexion aux données à utiliser avec un type particulier de connexion aux services Web.
Chaîne Lecture/écriture
3.144.4. Méthodes
Aucun
Objets de script
3.145. xsdConnection
L’objet xsdConnection stocke une entrée de connexion aux données du schéma XML.
3.145.1. Hiérarchie des objets
Modèle Objets enfant
Modèle connectionSet rootElementuri
3.145.2. Classe parent
node class catégorie
3.145.3. Propriétés
Nom Description Type Accès
dataDescription Spécifie le nom de la description d’une connexion aux données à utiliser avec un type particulier de connexion aux services Web.
Chaîne Lecture/écriture
3.145.4. Méthodes
Aucun
180
Propriétés de script 4
4. Propriétés de script
181
Toutes les propriétés prises en charge dans cet environnement de scripts ont un accès en lecture/écriture, sauf indications contraires.
REMARQUE : le formulaire DOM étant rare, les nœuds ne peuvent être générés que lorsqu’on y accède ou lorsqu’ils sont nécessaires. L’accès aux propriétés des nœuds n’est pas une manière précise de déterminer les enfants ou les propriétés d’un objet.
4.1. #text
Une chaîne de texte.
4.1.1. Syntaxe
Reference_Syntax.#text.value = "text"
4.1.2. Valeurs
Type Valeurs
Chaîne Toute chaîne valide.
4.1.3. Version
XFA 2.1
4.1.4. Exemples
4.1.5. JavaScript
TextField1.caption.value.resolveNode("#text").value = "This is a caption.";
Propriétés de script
4.1.6. FormCalc
TextField1.caption.value.#text.value = "This is a caption."
4.2. {default}
Représente la valeur réelle stockée par un objet.
Le type et les valeurs possibles varient selon l’objet.
4.2.1. Syntaxe
Reference_Syntax = "value"
4.2.2. Valeurs
Type Valeurs
Variable Les valeurs varient selon les objets.
4.2.3. Application
Modèle Objet
Modèle de données dataValue
Modèle de formulaire booleandatedateTimedecimaldrawexclGroupexDatafieldfloatimageintegerpicturetexttime
182
Propriétés de script 4
183
S’applique également aux objets provenant de la classe textNode class .
Modèle sourceSet booleanintegertext
Modèle Objet
4.2.4. Version
XFA 2.1
4.3. access
Définit l’accès de l’utilisateur au contenu d’un objet conteneur, tel qu’un sous-formulaire.
4.3.1. Syntaxe
Reference_Syntax.access = "open | protected | readOnly | nonInteractive"
Propriétés de script
4.3.2. Valeurs
Type Valeurs
Chaîne open(par défaut)Permet de mettre à jour le contenu d’un conteneur et d’y accéder sans restriction. Dans les formulaires interactifs, vous pouvez modifier le contenu et l’onglet du conteneur ou encore le parcourir. Le conteneur génère des événements.protectedL’application de traitement empêche l’utilisateur d’apporter des modifications directes au contenu du conteneur. Il est possible d’apporter des modifications indirectes, telles que des calculs. Le conteneur n’est pas inclus dans l’ordre de tabulation, bien que l’application permette de sélectionner du texte pour le copier dans le Presse-papiers. Un conteneur protégé ne génère pas d’événement.readOnlyL’application empêche l’utilisateur d’apporter des modifications directes au contenu du conteneur, mais l’autorise à apporter des modifications indirectes, telles que des calculs. Le conteneur est inclus dans l’ordre de tabulation et permet à l’utilisateur d’afficher le contenu. L’utilisateur peut sélectionner le contenu du conteneur pour le copier dans le Presse-papiers. Le conteneur génère également un sous-ensemble d’événements, lesquels ne sont pas associés aux modifications directes du contenu.nonInteractiveL’application permet de charger le contenu du conteneur à partir du document, mais sans mise à jour interactive. Les calculs sont effectués au moment du chargement, mais le contenu du conteneur n’est pas recalculé ensuite. Il n’est pas possible de modifier le contenu du conteneur à l’aide de scripts ou en faisant appel à des services Web.
4.3.3. Application
Modèle Objet
Modèle de formulaire exclGroupfieldsous-formulaire
4.3.4. Version
XFA 2.1
4.3.5. Exemples
4.3.6. JavaScript
TextField1.access = "readOnly";
184
Propriétés de script 4
4.3.7. FormCalc
185
TextField1.access = "readOnly"
LIENS CONNEXES :Référence aux objetsModification de la couleur d’arrière-planDésactivation de tous les champs d’un formulaire
4.4. accessKey
Spécifie une touche d’accès rapide utilisée par une application interactive pour déplacer la cible d’action vers un élément de champ particulier.
4.4.1. Syntaxe
Reference_Syntax.accessKey = "character"
4.4.2. Valeurs
Type Valeurs
Chaîne La valeur de cet attribut est un caractère unique. Lorsque l’utilisateur appuie simultanément sur la touche de modification propre à sa plate-forme et sur le caractère unique, la sélection du formulaire se déplace sur ce champ. Sur les systèmes Windows, la touche de modification est la touche ALT ; sur les systèmes Mac OS, il s’agit de la touche OPTION.Par exemple, si l’auteur du formulaire définit la propriété accessKey d’un champ sur f f et qu’un utilisateur Windows appuie sur Alt+f, la sélection se déplace sur ce champ.Lorsqu’ils créent des formulaires contenant des touches d’accès rapide, les concepteurs doivent informer les utilisateurs de la disponibilité de ces touches.
4.4.3. Application
Modèle Objet
Modèle de formulaire exclGroupfield
Propriétés de script
4.4.4. Version
XFA 2.2
4.4.5. Exemples
4.4.6. JavaScript
TextField1.accessKey = "f";
4.4.7. FormCalc
TextField1.accessKey = "f"
4.5. action
Identifie les nœuds de formulaire protégés par une signature de document.
4.5.1. Syntaxe
Reference_Syntax.action = "include | exclude | all"
4.5.2. Valeurs
Type Valeurs
Chaîne include(par défaut)
La signature de document protège tous les nœuds de formulaire à remplir dans la collection spécifiée. Cette option nécessite au moins un objet enfant ref valide dont la valeur de texte est une expression de syntaxe de référence identifiant des nœuds protégés par la signature de document.
exclude
La signature de document protège tous les nœuds de formulaire à remplir ne se trouvant pas dans la collection spécifiée. Cette option nécessite au moins un objet enfant ref valide dont la valeur de texte est une expression de syntaxe de référence identifiant des nœuds protégés par la signature de document.
all
La signature de document protège tous les nœuds de formulaire à remplir.
186
Propriétés de script 4
4.5.3. Application
187
Modèle Objet
Modèle de formulaire manifest
4.5.4. Version
XFA 2.4
4.6. activity
Indique le nom de l’événement.
La propriété ref associée doit spécifier un objet pouvant générer l’événement nommé.
4.6.1. Syntaxe
Reference_Syntax.activity = "change | click | docClose | docReady | enter | exit | full | initialize | mouseDown | mouseEnter | mouseExit | mouseUp | postExecute | postPrint | postSave | preExecute | prePrint | preSave | preSubmit | ready | validationState"
4.6.2. Valeurs
Type Valeur
Chaîne change
Se produit lorsque l’utilisateur exécute une action, telle que le collage de texte. Voici d’autres exemples d’actions qui déclenchent l’événement de modification :
• Lors de chaque frappe de touche
• Lorsque le texte est collé
• Lorsqu’une nouvelle sélection est effectuée
• Lors de la sélection d’une case à cocher
• Lors de la sélection d’un élément
Propriétés de script
click(par défaut)
Se produit lorsque l’utilisateur clique dans le champ. Sur la plupart des systèmes, un clic représente l’action d’appuyer sur le bouton de la souris et de le relâcher en déplaçant le pointeur le moins possible.
docClose
Cet événement est exécuté à chaque fin de formulaire, si et seulement si toutes les validations de formulaire se sont terminées sans erreur. Lorsque cet événement se déclenche, vous ne pouvez plus modifier un document enregistré, l’objectif étant de donner la possibilité de générer un état « quitter » ou un message d’accomplissement.
docReady
Cet événement est exécuté avant que le document ne soit rendu, mais après la liaison de données.
enter
Pour un champ, cet événement se déclenche lorsque le champ atteint la cible d’action du clavier. Pour un sous-formulaire ou un groupe d’exclusion, cet événement se déclenche lorsqu’un champ du sous-formulaire ou du groupe d’exclusion atteint la cible d’action du clavier, c’est-à-dire lorsque la cible d’action du clavier se déplace de l’extérieur vers l’intérieur de l’objet.
enter
Pour un champ, cet événement se déclenche lorsque le champ atteint la cible d’action du clavier. Pour un sous-formulaire ou un groupe d’exclusion, cet événement se déclenche lorsqu’un champ du sous-formulaire ou du groupe d’exclusion atteint la cible d’action du clavier, c’est-à-dire lorsque la cible d’action du clavier se déplace de l’extérieur vers l’intérieur de l’objet.
exit
Pour un champ, cet événement se déclenche lorsque le champ n’est plus contrôlé par la cible d’action du clavier. Pour un sous-formulaire ou un groupe d’exclusion, cet événement se déclenche lorsque l’ensemble des champs du sous-formulaire ou du groupe d’exclusion n’est plus contrôlé par la cible d’action du clavier, c’est-à-dire lorsque la cible d’action se déplace de l’intérieur vers l’extérieur de l’objet.
full
Cet événement se déclenche lorsque l’utilisateur tente de saisir le contenu maximum autorisé dans un champ.
initialize
Cet événement est exécuté une fois la liaison de données terminée. Un événement séparé est généré pour chaque instance du sous-formulaire dans le modèle de formulaire.
mouseDown
Se produit lorsque l’utilisateur appuie sur le bouton de la souris dans le champ, mais avant que ce dernier ne soit relâché.
mouseEnter
Se produit lorsque l’utilisateur fait glisser le pointeur sur le champ sans nécessairement appuyer sur le bouton.
Type Valeur
188
Propriétés de script 4
189
mouseExit
Se produit lorsque l’utilisateur fait glisser le pointeur hors du champ sans nécessairement appuyer sur le bouton.
mouseUp
Se produit lorsque l’utilisateur relâche le bouton de la souris dans le champ.
postExecute
Se produit lorsque des données sont envoyées vers un service Web via WSDL, juste après réception de la réponse à la requête et après que les données reçues ont été classées dans un objet connectionData sous $datasets. Un script déclenché par cet événement peut consulter et traiter les données reçues. Une fois cet événement exécuté, les données reçues sont effacées.
postPrint
Cet événement se produit juste après que le formulaire rendu a été envoyé à l’imprimante, au programme d’impression différée ou à la destination de sortie.
postSave
Cet événement se produit juste après que le formulaire été enregistré au format PDF ou XDP. Cet événement ne se produit pas si le modèle de données ou un autre sous-ensemble du formulaire est exporté au format XDP.
preExecute
Se produit lorsqu’une requête est envoyée à un service Web via WSDL. Un script déclenché par cet événement peut consulter et modifier les données avant l’envoi de la requête. Si le script est défini de sorte à être exécuté uniquement sur le serveur, les données sont envoyées au serveur avec l’instruction d’exécuter le script associé avant tout autre traitement.
preSave
Se produit juste après que les données du formulaire ont été enregistrées au format PDF ou XDP. Cet événement ne se produit pas si le modèle de données ou un autre sous-ensemble du formulaire est exporté au format XDP. Le post-traitement XSLT, s’il est activé, a lieu après cet événement.
preSubmit
Se produit lorsque des données sont envoyées à l’hôte via le protocole HTTP. Un script déclenché par cet événement peut consulter et modifier les données avant leur envoi. Si le script est défini de sorte à être exécuté sur le serveur, les données sont envoyées au serveur avec l’instruction d’exécuter le script associé avant tout autre traitement.
ready
Se produit lorsque le chargement du modèle est terminé.
Type Valeur
Propriétés de script
validationState
Se déclenche lorsque l’état de validation d’un champ, sous-formulaire ou groupe d’exclusion change. L’état de validation change lors du passage de l’état valide à l’état non valide, ou lorsque le test ayant provoqué l’état non valide change.L’utilisation de l’événement vise à modifier l’apparence des champs lorsqu’ils deviennent valides ou non valides.La propriété event.target est remplie avec l’objet conteneur dont l’état de validation a changé.La propriété event.name est remplie avec le nom de l’activité (validationState).Lorsqu’un champ, un groupe d’exclusion ou un sous-formulaire est initialisé, l’événement validationState se déclenche immédiatement après l’événement initialize correspondant à cet objet.L’événement ne doit se déclencher à nouveau que lorsque l’état de validation change. Cependant, la logique du formulaire doit être suffisamment robuste pour permettre à l’événement de se déclencher, même si l’état de validation n’a pas réellement changé.La propriété validationState ne se déclenche qu’après l’évaluation de l’état de validation pour tous les objets inclus dans l’opération de validation.Vous pouvez déterminer si l’événement cible est valide en vérifiant si la propriété $event.target.errorText possède une valeur.
Type Valeur
4.6.3. Application
Modèle Objet
Modèle de formulaire event
4.6.4. Version
XFA 2.1
4.6.5. Exemples
4.6.6. JavaScript
TextField1.event.activity = "mouseEnter";
4.6.7. FormCalc
TextField1.event.activity = "mouseEnter"
190
Propriétés de script 4
4.7. addRevocationInfo
191
Indique si l’état du certificat est vérifié lorsqu’une signature numérique est signée. L’état du certificat peut être vérifié à l’aide d’une liste de révocation des certificats ou d’une réponse OCSP (Online Certificate Status Protocol).
La personne qui appose la signature doit avoir accès à Internet pour récupérer la liste de révocation des certificats ou la réponse OCSP du serveur approprié.
La propriété addRevocationInfo ne possède pas de valeur par défaut afin qu’Acrobat puisse la remplacer au cas où la valeur ne serait pas spécifiée.
4.7.1. Syntaxe
Reference_Syntax.addRevocationInfo = "required | optional | none"
4.7.2. Valeurs
Type Valeurs
Chaîne Obligatoire
La vérification de l’état du certificat est obligatoire.
Facultatif
La vérification de l’état du certificat est facultative.
Aucun
Une liste de révocation des certificats ou une réponse OCSP n’est pas incluse dans la signature numérique.
4.7.3. Application
Modèle Objet
Modèle de formulaire filter
4.7.4. Version
XFA 2.5
Propriétés de script
4.8. after (désapprouvée)
Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu après la génération du sous-formulaire.
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir breakAfter.
4.8.1. Syntaxe
Reference_Syntax.after = "auto | contentArea | pageArea | pageEven | pageFront | pageOdd"
4.8.2. Valeurs
192
Type Valeurs
Chaîne Les comportements décrits ci-dessous peuvent être affinés par la sélection facultative d’une page de destination ou d’une zone de contenu via la propriété afterTarget (désapprouvée).
auto(par défaut)
La détermination d’une transition vers une nouvelle page ou zone de contenu sera déléguée à l’application de traitement. Aucune transition vers une nouvelle page ou zone de contenu ne sera imposée.
contentArea
La transition de rendu sera effectuée vers la prochaine zone de contenu disponible.
pageArea
La transition de rendu vers une nouvelle page sera effectuée.
pageBack
Lors d’une impression recto-verso, la transition du rendu est effectuée vers la prochaine surface arrière disponible, ce qui peut entraîner l’impression d’une surface de page intercalée. Lorsque l’option recto-verso est désactivée, la transition du rendu est effectuée vers une nouvelle page.
pageEven
La transition du rendu est effectuée vers la prochaine page à numérotation paire disponible, ce qui peut entraîner l’impression de pages numérotées ou non numérotées intercalées. Ce comportement ne nécessite pas de configuration recto-verso.
pageFront
Lors d’une impression recto-verso, la transition du rendu est effectuée vers la prochaine surface avant disponible, ce qui peut entraîner l’impression d’une surface de page intercalée. Lorsque l’option recto-verso est désactivée, la transition du rendu est effectuée vers une nouvelle page.
pageOdd
La transition du rendu est effectuée vers la prochaine page à numérotation impaire disponible, ce qui peut entraîner l’impression de pages numérotées ou non numérotées intercalées. Ce comportement ne nécessite pas de configuration recto-verso.
Propriétés de script 4
4.8.3. Application
193
Modèle Objet
Modèle de formulaire break (désapprouvé)
4.8.4. Version
XFA 2.1
4.8.5. Exemples
4.8.6. JavaScript
Subform1.break.after = "pageOdd";
4.8.7. FormCalc
Subform1.break.after = "pageOdd"
4.9. afterTarget (désapprouvée)
Spécifie la page de destination ou la zone de contenu explicite pour la propriété after (désap-prouvée).
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir breakAfter.target.
4.9.1. Syntaxe
Reference_Syntax.afterTarget = "auto | contentArea | pageArea | pageEven | page-Front | pageOdd"
Propriétés de script
4.9.2. Valeurs
Type Valeurs
Chaîne La valeur de cette propriété doit être compatible avec la valeur de la propriété after (désapprouvée). Par exemple, il serait considéré comme une erreur que la propriété after (désapprouvée) identifie une zone de page et que la propriétéafterTargetidentifie une zone de contenu, ou vice versa.
4.9.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)
4.9.4. Version
XFA 2.1
4.9.5. Exemples
4.9.6. JavaScript
Subform1.break.afterTarget = "pageEven";
4.9.7. FormCalc
Subform1.break.afterTarget = "pageEven"
4.10. aliasNode
Indique l’objet représenté par le pseudonyme pour ce modèle.
4.10.1. Syntaxe
Reference_Syntax.aliasNode = "object"
194
Propriétés de script 4
4.10.2. Valeurs
195
Type Valeurs
Objet Objet dans le modèle identifié par la syntaxe de référence de ce modèle. Dans le cas du modèle de formulaire, le nœud d’alias serait l’objet formulaire.Pour plus d’informations sur les expressions de syntaxe de référence, voir Référence aux objets dans les calculs et scripts.
4.10.3. Application
model, classe classe
4.10.4. Version
XFA 2.1
4.10.5. Exemples
4.10.6. JavaScript
xfa.aliasNode = "form";
4.10.7. FormCalc
xfa.aliasNode = "form"
4.11. all
Renvoie une collection de nœuds de même nom et compris dans la plage indiquée.
Si le nœud est dépourvu de nom, une collection de même classe est renvoyée.
4.11.1. Syntaxe
Reference_Syntax.all = "object(s)"
Propriétés de script
4.11.2. Valeurs
Type Valeurs
Objet Un objet ou une collection d’objets.
4.11.3. Application
tree, classe classe
4.11.4. Version
XFA 2.1
4.11.5. Exemples
4.11.6. JavaScript
Subform1.all;
4.11.7. FormCalc
Subform1.all
4.12. allowMacro
Spécifie si l’application de traitement est autorisée ou non à optimiser les résultats en créant une macro d’imprimante pour tout le contenu de dessin du sous-formulaire.
4.12.1. Syntaxe
Reference_Syntax.allowMacro = "1 | 0"
196
Propriétés de script 4
4.12.2. Valeurs
197
Type Valeurs
Chaîne 1(par défaut)
L’application de traitement est autorisée à utiliser une macro d’imprimante pour ce sous-formulaire.
0
L’application de traitement ne peut pas utiliser de macro d’imprimante pour ce sous-formulaire.
4.12.3. Application
Modèle Objet
Modèle de formulaire sous-formulaire
4.12.4. Version
XFA 2.1
4.12.5. Exemples
4.12.6. JavaScript
Subform1.allowMacro = "0";
4.12.7. FormCalc
Subform1.allowMacro = "0"
Propriétés de script
4.13. allowNeutral
Indique si la case à cocher ou le bouton radio prend en charge un troisième état représentant une valeur neutre.
4.13.1. Syntaxe
Reference_Syntax.allowNeutral = "0 | 1"
4.13.2. Valeurs
Type Valeurs
Chaîne 0(par défaut)
La case à cocher ou le bouton radio prend en charge deux états, représentant la valeur vrai ou faux.
1
La case à cocher ou le bouton radio prend en charge trois états : vrai, faux ou neutre.
4.13.3. Application
Modèle Objet
Modèle de formulaire checkButton
4.13.4. Version
XFA 2.1
4.13.5. Exemples
4.13.6. JavaScript
CheckBox1.resolveNode("ui.#checkButton").allowNeutral = "1";
198
Propriétés de script 4
4.13.7. FormCalc
199
CheckBox1.ui.#checkButton.allowNeutral = "1"
4.14. allowRichText
Indique si le texte est compatible avec les styles (ce qu’on appelle également du texte enrichi).
REMARQUE : La propriété allowRichText ne fait que transmettre les paramètres de style à l’interface de l’application. Quelle que soit sa valeur, elle n’empêche en aucun cas un utilisateur de saisir une annotation de texte normal, assortie d’attributs de style. Par exemple, quel que soit le paramètre défini pour cette propriété, un utilisateur peut taper :
<b>hello</b>
4.14.1. Syntaxe
Reference_Syntax.allowRichText = "0 | 1"
4.14.2. Valeurs
Type Valeurs
Chaîne 0(par défaut)
Les styles de texte ne sont pas pris en charge. Il s’agit du paramètre par défaut lorsque l’objet textEdit ne contient pas d’objet exData.
1
Les styles de texte sont pris en charge. Il s’agit du paramètre par défaut lorsque l’objet textEdit contient un objet exData.
4.14.3. Version
XFA 2.1
Modèle Objet
Modèle de formulaire textEdit
Propriétés de script
4.14.4. Exemples
4.14.5. JavaScript
TextField1.resolveNode("ui.#textEdit").allowRichText = "1";
4.14.6. FormCalc
TextField1.ui.#textEdit.allowRichText = "1"
4.15. anchorType
Indique l’emplacement du point d’ancrage du conteneur lors de l’utilisation d’une stratégie de disposition positionnée.
4.15.1. Syntaxe
Reference_Syntax.anchorType = "topLeft | topCenter | topRight | middleLeft | middleCenter | middleRight | bottomLeft | bottomCenter | bottomRight"
200
Propriétés de script 4
4.15.2. Valeurs
201
Type Valeurs
Chaîne topLeft(par défaut)Coin supérieur gauche du conteneur.
topCenter
Centre du bord supérieur du conteneur.
topRight
Coin supérieur droit du conteneur.
middleLeft
Milieu du bord gauche du conteneur.
middleCenter
Milieu du conteneur.
middleRight
Milieu du bord droit du conteneur.
bottomLeft
Coin inférieur gauche du conteneur.
bottomCenter
Centre du bord inférieur du conteneur.
bottomRight
Coin inférieur droit du conteneur.
4.15.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldsous-formulaire
4.15.4. Version
XFA 2.1
Propriétés de script
4.15.5. Exemples
4.15.6. JavaScript
TextField1.anchorType = "bottomRight";
4.15.7. FormCalc
TextField1.anchorType = "bottomRight"
4.16. appType
Indique le nom de l’application cliente contenant un formulaire existant.
La propriété appType appelle la propriété viewerType appelle la propriété à partir du modèle d’objet JavaScript et renvoie la valeur correspondante pour l’application client contenant le formulaire. Par exemple, dans le contexte d’un formulaire PDF visualisé dans Adobe Reader, cette propriété renvoie Reader.
Pour plus d’informations sur la propriété viewerType et les valeurs qu’elle renvoie, voir Javascript for Acrobat API Reference.
4.16.1. Syntaxe
Reference_Syntax.appType
4.16.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom de l’application cliente hôte actuelle.
202
Propriétés de script 4
4.16.3. Application
203
Modèle Objet
Modèle de formulaire drawexclGroupfieldsous-formulaire
Modèle Host hostPseudoModel
4.16.4. Version
XFA 2.1
4.16.5. Exemples
4.16.6. JavaScript
xfa.host.appType;
4.16.7. FormCalc
xfa.host.appType
4.17. archive
Spécifie l’emplacement URI d’un fichier d’archive pouvant contenir un code de programmation associé à l’objet exObject.
4.17.1. Syntaxe
Reference_Syntax.archive = "URI"
Propriétés de script
4.17.2. Valeurs
Type Valeurs
Chaîne Valeur URI complètement qualifiée.
4.17.3. Application
Modèle Objet
Modèle de formulaire exObject
4.17.4. Version
XFA 2.1
4.18. aspect
Indique le mode de mappage de l’image à la zone de contenu nominale du conteneur de l’image.
4.18.1. Syntaxe
Reference_Syntax.aspect = "fit | none | actual | width | height"
204
Propriétés de script 4
4.18.2. Valeurs
205
Type Valeurs
Chaîne Ajuster(par défaut)
L’application met l’image à l’échelle proportionnellement à la taille maximale de la zone de contenu du conteneur.
none
L’application met l’image à l’échelle selon la taille de toute la zone de contenu du conteneur. Conséquence : des valeurs d’échelle différentes peuvent être appliquées aux coordonnées (X, Y) de l’image.
réel
Le rendu de l’image est généré à partir des dimensions stockées dans le contenu. La taille de la zone du conteneur n’a aucun impact sur les dimensions de l’image.
width
L’application met l’image à l’échelle proportionnellement à la largeur de la zone de contenu du conteneur. L’image peut se révéler plus longue ou plus courte que la zone de contenu.
height
L’application met l’image à l’échelle proportionnellement à la hauteur de la zone de contenu du conteneur. L’image peut se révéler plus large ou plus étroite que la zone de contenu.
4.18.3. Application
Modèle Objet
Modèle de formulaire image
4.18.4. Version
XFA 2.1
4.18.5. Exemples
4.18.6. JavaScript
ImageField1.resolveNode("value.#image").aspect = "actual";
Propriétés de script
4.18.7. FormCalc
ImageField1.value.#image.aspect = "actual"
4.19. baselineShift
Indique une mesure positive permettant de décaler une police vers le haut par rapport à la ligne de base ou indique une mesure négative décalant une police vers le bas par rapport à la ligne de base.
4.19.1. Syntaxe
Reference_Syntax.baselineShift = "0in | measurement"
4.19.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.19.3. Application
Modèle Objet
Modèle de formulaire font
4.19.4. Version
XFA 2.1
206
Propriétés de script 4
4.19.5. Exemples
4.19.6. JavaScript
207
TextField1.font.baselineShift = "-5pt";
4.19.7. FormCalc
TextField1.font.baselineShift = "-5pt"
4.20. before (désapprouvée)
Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu avant la génération du sous-formulaire.
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir breakBefore.
4.20.1. Syntaxe
Reference_Syntax.before = "auto | contentArea | pageArea | pageBack | pageEven | pageFront | pageOdd"
Propriétés de script
4.20.2. Valeurs
Type Valeurs
Chaîne Les comportements décrits ci-dessous peuvent être affinés par la sélection facultative d’une page de destination ou d’une zone de contenu à l’aide de la propriété beforeTarget (désapprouvée). La propriété startNew modifie aussi certains de ces comportements :
auto(par défaut)
La détermination d’une transition vers une nouvelle page ou zone de contenu est déléguée à l’application de traitement. Aucune transition vers une nouvelle page ou zone de contenu n’est imposée.
contentArea
Transitions de rendu vers la prochaine zone de contenu disponible. Voir aussi la section startNew.
pageArea
Transitions de rendu vers une nouvelle page. Voir aussi la section startNew.
pageBack
Lors d’une impression recto-verso, la transition du rendu est effectuée vers la prochaine surface arrière disponible, ce qui peut entraîner l’impression d’une surface de page intercalée. Lorsque l’impression recto-verso est désactivée, la transition du rendu est effectuée vers une nouvelle page. Notez que pageBack, au contraire de pageEven, n’est pas affectée par la numérotation des pages.
pageEven
La transition du rendu est effectuée vers la prochaine page à numérotation paire disponible, ce qui peut entraîner l’impression de pages numérotées ou non numérotées intercalées. Ce comportement ne nécessite pas de configuration recto-verso.
pageFront
Lors d’une impression recto-verso, la transition du rendu est effectuée vers la prochaine surface avant disponible, ce qui peut entraîner l’impression d’une surface de page intercalée. Lorsque l’impression recto-verso est désactivée, la transition du rendu est effectuée vers une nouvelle page. Notez que pageFront, au contraire de pageOdd, n’est pas affectée par la numérotation des pages.
pageOdd
La transition du rendu est effectuée vers la prochaine page à numérotation impaire disponible, ce qui peut entraîner l’impression de pages numérotées ou non numérotées intercalées. Ce comportement ne nécessite pas de configuration recto-verso.
4.20.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)
208
Propriétés de script 4
4.20.4. Version
209
XFA 2.1
4.20.5. Exemples
4.20.6. JavaScript
Subform1.break.before = "contentArea";
4.20.7. FormCalc
Subform1.break.before = "contentArea"
4.21. beforeTarget (désapprouvée)
Spécifie la page de destination ou la zone de contenu explicite pour la propriété before (désapprouvée).
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir breakBefore.target.
4.21.1. Syntaxe
Reference_Syntax.beforeTarget = "auto | contentArea | pageArea | pageEven | page-Front | pageOdd"
4.21.2. Valeurs
Type Valeurs
Chaîne La valeur de la propriété beforeTarget doit être compatible avec la valeur de la propriété before (désapprouvée). Par exemple, il serait considéré comme une erreur que la propriété before (désapprouvée) possède une valeur de pageArea et que la propriété beforeTarget identifie une zone de contenu, ou vice versa.
Propriétés de script
4.21.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)
4.21.4. Version
XFA 2.1
4.21.5. Exemples
4.21.6. JavaScript
Subform1.break.beforeTarget = "#contentArea_ID";
4.21.7. FormCalc
Subform1.break.beforeTarget = "#contentArea_ID"
4.22. bind
Spécifie le nom d’un ID de liaison unique selon lequel les colonnes de la source de données spécifiées par la propriété from sont liées.
4.22.1. Syntaxe
Reference_Syntax.bind = "string"
4.22.2. Valeurs
Type Valeurs
Chaîne Chaîne valable représentant un ID de liaison.
210
Propriétés de script 4
4.22.3. Application
211
Modèle Objet
Modèle sourceSet map
4.22.4. Version
XFA 2.1
4.23. binding
Identifie le type d’application auquel s’adresse le script.
4.23.1. Syntaxe
Reference_Syntax.binding = "XFA | Application_type"
4.23.2. Valeurs
Type Valeurs
Chaîne • XFA(par défaut)
• Tout autre type d’application valide.
Le script doit être appliqué par une application standard.
• Tout autre type d’application valide.
Toute valeur autre queXFAsignifie que le script peut être ignoré par les applications standard.
4.23.3. Application
Modèle Objet
Modèle de formulaire script
Propriétés de script
4.23.4. Version
XFA 2.1
4.23.5. Exemples
4.23.6. JavaScript
TextField1.resolveNode("#event.#script").binding = "XFA";
4.23.7. FormCalc
TextField1.#event.#script.binding = "XFA"
4.24. blank (désapprouvée)
Spécifie si la zone de page doit être vierge et par conséquent faire l’objet d’un traitement particulier par le périphérique de sortie.
4.24.1. Syntaxe
Reference_Syntax.blank = "0 | 1"
4.24.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
La zone de page ne doit pas être vierge, et tous les contenus sont rendus.
• 1
La zone de page doit être vierge et peut faire l’objet d’un traitement particulier par le périphérique de sortie.Par exemple, une imprimante peut facturer l’utilisateur à la page imprimée. L’utilisateur ne souhaite pas se voir facturer les versos vierges des pages imprimées recto-verso. Grâce à cette propriété, les versos vierges du document sont signalés comme tel, ce qui interdit à l’application de traitement de rendre le contenu sur le verso et signale à l’imprimante de vérifier que ce verso vierge n’est pas facturé à l’utilisateur.
212
Propriétés de script 4
4.24.3. Application
213
Modèle Objet
Modèle de formulaire pageArea
4.24.4. Version
XFA 2.1
4.24.5. Exemples
L’expression de syntaxe de référence varie selon l’objet à partir duquel elle est appelée.
4.24.6. JavaScript
xfa.form.form1.pageSet.Page1.blank;
4.24.7. FormCalc
xfa.form.form1.pageSet.Page1.blank
4.25. blankOrNotBlank
Spécifie si la zone de page doit être vierge et par conséquent faire l’objet d’un traitement particulier par le périphérique de sortie.
4.25.1. Syntaxe
Reference_Syntax.blankOrNotBlank = "any | blank | notBlank"
Propriétés de script
4.25.2. Valeurs
Type Valeurs
Chaîne • quelconque(par défaut)
• blank
• notBlank
Représente n’importe quelle page vierge ou non vierge.
• blank
• notBlank
Représente une page insérée par un saut vers une page paire lorsqu’il s’agit d’une page paire, ou par un saut vers une page impaire lorsqu’il s’agit d’une page impaire.
• notBlank
Représente n’importe quelle page insérée pour héberger du contenu ou respecter les règles d’occurrence minimale.
4.25.3. Application
Modèle Objet
Modèle de formulaire pageArea
4.25.4. Version
XFA 2.5
4.25.5. Exemples
L’expression de syntaxe de référence varie selon l’objet à partir duquel elle est appelée.
4.25.6. JavaScript
xfa.form.form1.pageSet.Page1.blankOrNotBlank = "notBlank";
214
Propriétés de script 4
4.25.7. FormCalc
215
xfa.form.form1.pageSet.Page1.blankOrNotBlank = "notBlank"
4.26. bofAction
Spécifie l’opération à effectuer si l’enregistrement actif est le premier du jeu d’enregistrements.
4.26.1. Syntaxe
Reference_Syntax.bofAction = "moveLast | stayEOF"
4.26.2. Valeurs
Type Valeurs
Chaîne • moveLast(par défaut)
• stayEOF
Déplace l’enregistrement actif vers un emplacement situé après le dernier enregistrement.
• stayEOF
L’enregistrement actif sera toujours le dernier enregistrement du jeu d’enregistrements.
4.26.3. Application
Modèle Objet
Modèle sourceSet recordSet
4.26.4. Version
XFA 2.1
Propriétés de script
4.27. bookendLeader (désapprouvée)
(bookendLeader) Indique un sous-formulaire à placer dans la zone de contenu ou la page active avant tout autre contenu.
Si les deux propriétés bookendLeader et bookendTrailer (désapprouvée) sont fournies, les deux sous-formulaires encadrent le contenu comme des pages de garde.
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir leader.
4.27.1. Syntaxe
Reference_Syntax.bookendLeader = "string"
4.27.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom ou l’expression de syntaxe de référence complète d’un sous-formulaire.
4.27.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)
4.27.4. Version
XFA 2.1
4.27.5. Exemples
4.27.6. JavaScript
Subform1.break.bookendLeader = "xfa.form.form1.Subform2";
216
Propriétés de script 4
4.27.7. FormCalc
217
Subform1.break.bookendLeader = "xfa.form.form1.Subform2"
4.28. bookendTrailer (désapprouvée)
Indique le sous-formulaire à placer dans la zone de contenu ou la page active après tout autre contenu.
Si les deux propriétés bookendLeader (désapprouvée) et bookendTrailer sont fournies, les deux sous-formulaires encadrent le contenu comme des pages de garde.
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir trailer.
4.28.1. Syntaxe
Reference_Syntax.bookendTrailer = "string"
4.28.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom ou l’expression de syntaxe de référence complète d’un sous-formulaire.
4.28.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)
4.28.4. Version
XFA 2.1
Propriétés de script
4.28.5. Exemples
4.28.6. JavaScript
Subform1.break.bookendTrailer = "xfa.form.form1.Subform2";
4.28.7. FormCalc
Subform1.break.bookendTrailer = "xfa.form.form1.Subform2"
4.29. borderColor
Indique la valeur de la couleur de la bordure pour ce champ.
Vous devez définir une bordure avant de modifier la couleur au moyen d’un script.
4.29.1. Syntaxe
Reference_Syntax.borderColor = " [0-255], [0-255], [0-255]"
4.29.2. Valeurs
Type Valeurs
Chaîne Pour l’espace colorimétrique SRVB, les valeurs des composantes doivent suivre le format r,v,b, où r est la valeur de la composante rouge, v celle de la composante verte et b celle de la composante bleue. Chaque valeur doit être comprise entre 0 et 255 (inclus). La valeur 255 représente l’intensité d’affichage maximale. Par exemple, 255,0,0 correspond à la couleur rouge.La couleur par défaut varie selon le contexte dans lequel une couleur est utilisée. Elle est déterminée par l’objet qui englobe l’objet de couleur.
4.29.3. Application
Modèle Objet
Modèle de formulaire exclGroupfieldsous-formulaire
218
Propriétés de script 4
4.29.4. Version
219
XFA 2.1
4.29.5. Exemples
4.29.6. JavaScript
TextField1.borderColor = "125,154,125";
4.29.7. FormCalc
TextField1.borderColor = "125,154,125"
4.30. borderWidth
Indique la largeur de la bordure pour ce champ.
4.30.1. Syntaxe
Reference_Syntax.borderWidth = "0in | measurement"
4.30.2. Valeurs
Type Valeurs
Chaîne • 0in (par défaut)
• Toute mesure valable.
4.30.3. Application
Modèle Objet
Modèle de formulaire exclGroupfieldsous-formulaire
Propriétés de script
4.30.4. Version
XFA 2.1
4.30.5. Exemples
4.30.6. JavaScript
TextField1.borderWidth = "0.05in";
4.30.7. FormCalc
TextField1.borderWidth = "0.05in"
4.31. bottomInset
Indique la taille d’une insertion en bas.
4.31.1. Syntaxe
Reference_Syntax.bottomInset = "0in | measurement"
4.31.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.31.3. Application
Modèle Objet
Modèle de formulaire margin
220
Propriétés de script 4
4.31.4. Version
221
XFA 2.1
4.31.5. Exemples
4.31.6. JavaScript
Subform1.margin.bottomInset = "1in";
4.31.7. FormCalc
Subform1.margin.bottomInset ="1in"
4.32. break
Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu après la génération d’un objet.
4.32.1. Syntaxe
Reference_Syntax.break = "close | open"
REMARQUE : Si vous utilisez JavaScript et souhaitez définir la propriété break pour l’objet enfant border d’un objet sous-formulaire, vous devez spécifier cette propriété et sa valeur au moyen de la méthode setAttribute. Dans cette instance, la syntaxe est définie de la façon suivante :
Reference_Syntax.setAttribute = ("close | open", "break")
4.32.2. Valeurs
Type Valeurs
Chaîne • close(par défaut)
• open
Propriétés de script
4.32.3. Application
Modèle Objet
Modèle de formulaire border
4.32.4. Version
XFA 2.1
4.32.5. Exemples
4.32.6. JavaScript
Subform1.border.setAttribute("open", "break");
4.32.7. FormCalc
Subform1.border.break = "open"
4.33. calculationsEnabled
Indique si les scripts de calcul seront exécutés ou non.
4.33.1. Syntaxe JavaScript
Reference_Syntax.calculationsEnabled = false | true; - or -Reference_Syntax.calculationsEnabled = 0 | 1;
4.33.2. Syntaxe FormCalc
Reference_Syntax.calculationsEnabled = 0 | 1
222
Propriétés de script 4
4.33.3. Valeurs
223
Type Valeurs
Booléen • true | 1(par défaut)
• false | 0
Les scripts de calcul seront exécutés.
• false | 0
Les scripts de calcul ne seront pas exécutés.
4.33.4. Application
Modèle Objet
Modèle Host hostPseudoModel
4.33.5. Version
XFA 2.1
4.33.6. Exemples
4.33.7. JavaScript
xfa.host.calculationsEnabled = 1;
4.33.8. FormCalc
xfa.host.calculationsEnabled = 1
Propriétés de script
4.34. cancelAction
Indique s’il est nécessaire ou non d’annuler une action à venir. Cette propriété ne s’applique qu’aux événements de scripts suivants : prePrint, preSubmit, preExecute, preOpen et preSign.
4.34.1. Syntaxe JavaScript
Reference_Syntax.cancelAction = false | true; - or - Reference_Syntax.cancelAction = 0 | 1;
4.34.2. Syntaxe FormCalc
Reference_Syntax.cancelAction = 0 | 1
4.34.3. Valeurs
Type Valeurs
Booléen • false | 0(par défaut)
• true | 1
• preOpen : la liste déroulante n’affiche pas les valeurs.
• preSubmit : le formulaire n’est pas envoyé.
• preSign : le formulaire n’est pas signé numériquement.
• prePrint : aucune boîte de dialogue d’impression ne s’affiche et le formulaire n’est pas imprimé.
L’action de l’utilisateur (impression, envoi ou signature numérique) se produit comme prévu.
• true | 1
• preOpen : la liste déroulante n’affiche pas les valeurs.
• preSubmit : le formulaire n’est pas envoyé.
• preSign : le formulaire n’est pas signé numériquement.
• prePrint : aucune boîte de dialogue d’impression ne s’affiche et le formulaire n’est pas imprimé.
224
Propriétés de script 4
225
Booléen L’action de l’utilisateur (impression, envoi ou signature numérique) ne se produit pas. La situation vécue par l’utilisateur est déterminée par l’événement de script contenant la référence cancelAction :
• preOpen : la liste déroulante n’affiche pas les valeurs.
• preSubmit : le formulaire n’est pas envoyé.
• preSign : le formulaire n’est pas signé numériquement.
• prePrint : aucune boîte de dialogue d’impression ne s’affiche et le formulaire n’est pas imprimé.
Type Valeurs
4.34.4. Application
Modèle Objet
Modèle Event eventPseudoModel
4.34.5. Version
XFA 2.8
4.34.6. Exemples
4.34.7. JavaScript
xfa.event.cancelAction = 1;
4.34.8. FormCalc
xfa.event.cancelAction = 1
Propriétés de script
4.35. cap
Spécifie le rendu d’extrémité du contour.
Les contours formant une zone fermée n’ont pas de rendu d’extrémité. En particulier, les limites des rectangles et bordures, ainsi que les arêtes des arcs à 360 degrés, ne sont pas considérés comme ayant une extrémité. Les arcs dotés d’angles de flèche de moins de 360 degrés et de lignes ont quant à eux deux points d’extrémité.
4.35.1. Syntaxe
Reference_Syntax.cap = "square | butt | round"
4.35.2. Valeurs
Type Valeurs
Chaîne • square(par défaut)
• butt
• round
Une fois le contour achevé, le rendu erroné présente un report des bords au-delà de leurs points d’extrémité à une distance correspondant à la moitié de l’épaisseur de la bordure.
• butt
• round
Une fois le contour achevé, le rendu erroné présente l’extrémité des bords chevauchant les points d’extrémité.
• round
Une fois le contour achevé, le rendu erroné présente un demi-cercle sur le point d’extrémité de la bordure, dont le rayon correspond à la moitié de l’épaisseur de la bordure.
4.35.3. Application
Modèle Objet
Modèle de formulaire edge
226
Propriétés de script 4
4.35.4. Version
227
XFA 2.1
4.35.5. Exemples
4.35.6. JavaScript
Line1.resolveNode("value.#line.edge").cap = "round";
4.35.7. FormCalc
Line1.value.#line.edge.cap = "round"
4.36. change
Indique la valeur saisie ou collée par un utilisateur dans un champ immédiatement après avoir effectué une opération.
4.36.1. Syntaxe
Reference_Syntax.change
4.36.2. Valeurs
Type Valeurs
Chaîne Toute valeur de chaîne valable adaptée à un champ de formulaire spécifique
4.36.3. Application
Modèle Objet
Modèle Event eventPseudoModel
Propriétés de script
4.36.4. Version
XFA 2.1
4.36.5. Exemples
4.36.6. JavaScript
xfa.event.change;
4.36.7. FormCalc
xfa.event.change
4.37. charEncoding
Spécifie le codage de caractères de la valeur codée dans un code à barres.
La valeur du champ de code à barres est numérotée dans une séquence d’octets en fonction du codage de caractères spécifié. Elle est ensuite compressée si la propriété dataPrep l’exige et chiffrée si l’objet encrypt est présent. Enfin, elle est codée en fonction de la symbologie.
REMARQUE : la valeur de cette propriété ne respecte pas la casse des caractères et doit correspondre à l’une des valeurs suivantes.
4.37.1. Syntaxe
Reference_Syntax.charEncoding = "UTF-8 | none | ISO-8859-1 | ISO-8859-2 | SO-8859-7 | SHift-JIS | KSC-5601 | Big-Five | GB-2312 | UTF-16 | UCS-2 | fontS-pecific"
228
Propriétés de script 4
4.37.2. Valeurs
229
Type Valeurs
Chaîne • UTF-8 (par défaut)
Les caractères sont codés à l’aide de points de code Unicode selon les normes Unicode et de la numérotation consécutive UTF-8 (selon la norme ISO/IEC 10646).
• none
Aucun codage spécifique n’est indiqué. Les caractères sont codés à l’aide du codage disponible sur le système d’exploitation.
• ISO-8859-1
Les caractères sont codés selon la norme ISO-8859-1, également connue sous l’appellation Latin-1.
• ISO-8859-2
Les caractères sont codés selon la norme ISO-8859-2. I
• SO-8859-7
Les caractères sont codés selon la norme ISO-8859-7.
• Shift-JIS
Les caractères sont codés selon la norme JIS X 0208, plus connue sous le nom de Shift-JIS.
• KSC-5601
Les caractères sont codés selon le code CII (Code for Information Interchange, Hangul et Hanja).
• Big-Five
Chaîne Les caractères sont codés en chinois traditionnel (Big-5). Il n’existe pas de norme officielle relative au codage Big-5. Aussi, plusieurs variantes sont disponibles. Le modèle d’objet de formulaire d’Adobe utilise la variante mise en œuvre par Microsoft® sous la forme de code.
• GB-2312
Les caractères sont codés en chinois simplifié.
• UTF-16
Les caractères sont codés à l’aide de points de code Unicode (selon les normes Unicode) et de la numérotation consécutive UCS-16 (selon la norme ISO/IEC 10646).
• UCS-2
Les caractères sont codés à l’aide de points de code Unicode selon les normes Unicode et de la numérotation consécutive UTF-2 (selon la norme ISO/IEC 10646).
• fontSpecific
Propriétés de script
4.37.3. Application
Modèle Objet
Modèle de formulaire barcode
4.37.4. Version
XFA 2.4
4.37.5. Exemples
4.37.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").charEncoding = "UCS-2";
4.37.7. FormCalc
Code11BarCode1.ui.#barcode.charEncoding = "UCS-2"
4.38. checksum
Indique un algorithme de la somme de contrôle à insérer dans un code à barres.
Le calcul des sommes de contrôle repose sur les données du code à barres.
La conception de modèle autorise l’un des choix présentés ci-dessous. Toutefois, certains formats de codes à barres exigent une somme de contrôle spécifique ou rejettent les sommes de contrôle. Dans ce cas, la propriété checksum n’est pas prise en compte. Parmi les formats de codes à barres restants, certains prennent en charge un jeu partiel limité des choix ci-dessous. Pour ce type de code à barres, la conception de modèle n’indique pas de choix non pris en charge.
4.38.1. Syntaxe
Reference_Syntax.checksum = "none | auto | 1mod10 | 2mod10 | 1mod10_1mod11"
230
Propriétés de script 4
4.38.2. Valeurs
231
Type Valeurs
Chaîne • none(par défaut)
• auto
• 1mod10
• 2mod10
• 1mod10_1mod11
N’insère pas de somme de contrôle.
• auto
• 1mod10
• 2mod10
• 1mod10_1mod11
Insère la somme de contrôle par défaut définie pour le format de code à barres.
• 1mod10
• 2mod10
• 1mod10_1mod11
Chaîne Insère une somme de contrôle 1 modulo 10.
• 2mod10
• 1mod10_1mod11
Insère une somme de contrôle 2 modulo 10.
• 1mod10_1mod11
Insère une somme de contrôle 1 modulo 10 suivie d’une somme de contrôle 1 modulo 11.1 modulo 10, 2 modulo 10 et 1 modulo 11 sont des normes de codes à barres. Voir la documentation relative à ces normes pour plus d’informations sur ce type de code à barres.
4.38.3. Application
Modèle Objet
Modèle de formulaire barcode
Propriétés de script
4.38.4. Version
XFA 2.1
4.38.5. Exemples
4.38.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").checksum = "2mod10";
4.38.7. FormCalc
Code11BarCode1.ui.#barcode.checksum = "2mod10"
4.39. circular
Permet de convertir un arc en cercle.
4.39.1. Syntaxe JavaScript
Reference_Syntax.circular = false | true; - or - Reference_Syntax.circular = 0 | 1;
4.39.2. Syntaxe FormCalc
Reference_Syntax.circular = 0 | 1
232
Propriétés de script 4
4.39.3. Valeurs
233
Type Valeurs
Booléen • false | 0(par défaut)
• true | 1
Ne transforme pas l’arc en tracé circulaire.
• true | 1
Transforme l’arc en tracé circulaire.Vous pouvez convertir un arc en cercle même si la zone de contenu de l’arc n’est pas carrée. Au besoin, la taille du cercle est ajustée à celle de la zone de contenu.
4.39.4. Application
Modèle Objet
Modèle de formulaire arc
4.39.5. Version
XFA 2.1
4.39.6. Exemples
4.39.7. JavaScript
Circle1.resolveNode("value.#arc").circular = 1;
4.39.8. FormCalc
Circle1.value.#arc.circular = 1
Propriétés de script
4.40. classAll
Renvoie une collection de nœuds de même classe et compris dans la plage indiquée.
REMARQUE : cette propriété est en lecture seule.
4.40.1. Syntaxe
Reference_Syntax.classAll = "objets"
4.40.2. Valeurs
Type Valeurs
Objet Série d’objets provenant de la même classe que l’objet actif et issu de la même plage.
4.40.3. Application
tree, classe classe
4.40.4. Version
XFA 2.1
4.40.5. Exemples
4.40.6. JavaScript
Subform1.classAll;
4.40.7. FormCalc
Subform1.classAll
234
Propriétés de script 4
4.41. classId
235
Spécifie un nom ou un emplacement URI pour le code de programmation représenté par l’objet.
4.41.1. Syntaxe
Reference_Syntax.classId = "URI"
4.41.2. Valeurs
Type Valeurs
Chaîne Toute valeur URI complètement qualifiée.
4.41.3. Application
Modèle Objet
Modèle de formulaire exObject
4.41.4. Version
XFA 2.1
4.42. classIndex
Renvoie la position de l’objet dans sa collection d’objets de même classe et compris dans la plage indiquée.
REMARQUE : cette propriété est en lecture seule.
4.42.1. Syntaxe
Reference_Syntax.classIndex = "integer"
Propriétés de script
4.42.2. Valeurs
Type Valeurs
Entier Entier représentant la position de l’index de base 0 pour l’objet actif par rapport à l’ensemble d’objets compris dans une même plage et provenant de la même classe.
4.42.3. Application
tree, classe classe
4.42.4. Version
XFA 2.1
4.42.5. Exemples
4.42.6. JavaScript
Subform1.classIndex;
4.42.7. FormCalc
Subform1.classIndex
4.43. className
Spécifie le nom de la classe de cet objet.
REMARQUE : cette propriété est en lecture seule.
4.43.1. Syntaxe
Reference_Syntax.className = "string"
236
Propriétés de script 4
4.43.2. Valeurs
237
Type Valeurs
Chaîne Chaîne valide représentant le nom de classe de l’objet spécifique.
4.43.3. Application
object, classe catégorie
4.43.4. Version
XFA 2.1
4.43.5. Exemples
4.43.6. JavaScript
Subform1.className;
4.43.7. FormCalc
Subform1.className
4.44. codeBase
Spécifie un emplacement URI pouvant être utilisé pour faciliter la résolution d’une propriété classId.
4.44.1. Syntaxe
Reference_Syntax.codeBase = "URI"
Propriétés de script
4.44.2. Valeurs
Type Valeurs
Chaîne Valeur URI complètement qualifiée.
4.44.3. Application
Modèle Objet
Modèle de formulaire exObject
4.44.4. Version
XFA 2.1
4.45. codeType
Spécifie un identifiant de type MIME capable d’identifier le code de programmation représenté par l’objet.
4.45.1. Syntaxe
Reference_Syntax.codeType = "Type de MIME"
4.45.2. Valeurs
Type Valeurs
Chaîne Un identifiant de type MIME valide. Par exemple application/java.
238
Propriétés de script 4
4.45.3. Application
239
Modèle Objet
Modèle de formulaire exObject
4.45.4. Version
XFA 2.1
4.46. colSpan
Spécifie le nombre de colonnes étendues par cet objet lorsqu’il est incorporé dans un sous-formulaire doté d’un type de disposition des rangées particulier.
4.46.1. Syntaxe
Reference_Syntax.colSpan = "1 | integer"
4.46.2. Valeurs
Type Valeurs
Chaîne • 1(par défaut)
• Tout nombre entier valide.
Propriétés de script
4.46.3. Application
Modèle Objet
Modèle de formulaire areadrawexclGroupfieldsous-formulaire
4.46.4. Version
XFA 2.1
4.46.5. Exemples
4.46.6. JavaScript
StaticText1.colSpan = "1";
4.46.7. FormCalc
StaticText1.colSpan = "1"
4.47. columnWidths
Spécifie la largeur des colonnes d’un tableau.
La propriété columnWidth est ignorée sauf si la propriété layout est définie sur table.
4.47.1. Syntaxe
Reference_Syntax.columnWidth = "measurement | -1 [, [, measurement | -1 ] ]"
240
Propriétés de script 4
4.47.2. Valeurs
241
Type Valeurs
Chaîne La valeur de cette propriété est un ensemble de jetons séparés par des espaces. Chaque jeton doit être une mesure valide ou-1. Si une mesure existe, la largeur de la colonne correspondante doit être définie sur cette valeur. Si la valeur -1existe, la colonne correspondante prend la largeur la plus importante affichée dans l’une des rangées du tableau.
4.47.3. Application
Modèle Objet
Modèle de formulaire sous-formulaire
4.47.4. Version
XFA 2.1
4.47.5. Exemples
4.47.6. JavaScript
Subform1.columnWidths = ".5in 1.5in";
4.47.7. FormCalc
Subform1.columnWidths = ".5in 1.5in"
Propriétés de script
4.48. commandType
Spécifie le type de commande utilisé par une requête de données.
4.48.1. Syntaxe
Reference_Syntax.commandType = "unknown | text | table | storedProc"
4.48.2. Valeurs
Type Valeurs
Chaîne • inconnu(e)(par défaut)
• text
• table
• storedProc
Une chaîne de requête SQL explicite stockée dans la base de données sans nom particulier.
• table
• storedProc
Un tableau stocké dans la base de données.
• storedProc
Une requête, SQL par exemple, créée pour interroger un ou plusieurs tableaux de la base de données, puis enregistrée dans la base de données sous un nom particulier.
4.48.3. Application
Modèle Objet
Modèle sourceSet query
4.48.4. Version
XFA 2.1
242
Propriétés de script 4
4.48.5. Exemples
243
Dans ces exemples, Titles désigne le nom de la connexion aux données.
4.48.6. JavaScript
xfa.sourceSet.Titles.nodes.item(1).query.setAttribute("text", "commandType");
4.48.7. FormCalc
xfa.sourceSet.Titles.nodes.item(1).query.setAttribute("text", "commandType")
4.49. commitKey
Indique comment l’utilisateur a défini la valeur actuelle d’un champ de formulaire.
4.49.1. Syntaxe
Reference_Syntax.commitKey = "0 | 1 | 2 | 3"
4.49.2. Valeurs
Type Valeurs
Entier • 0 (valeur par défaut)• 1
• 2
• 3
La valeur n’a pas été définie (lorsque, par exemple, l’utilisateur appuie sur la touche Echap avant que le champ de formulaire ne perde la cible d’action).
• 1
• 2
• 3
Propriétés de script
Entier La valeur est définie lorsqu’un utilisateur clique en dehors du champ avec le bouton gauche de la souris.
• 2
• 3
La valeur est définie lorsqu’un utilisateur appuie sur la touche Entrée.
• 3
La valeur est définie lorsqu’un utilisateur passe à un nouveau champ à l’aide de la touche de tabulation.
Type Valeurs
4.49.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.49.4. Version
XFA 2.1
4.49.5. Exemples
4.49.6. JavaScript
xfa.event.commitKey = "2";
4.49.7. FormCalc
xfa.event.commitKey = "2"
244
Propriétés de script 4
4.50. commitOn
245
Indique lorsque les sélections de l’utilisateur sont transmises au modèle de données.
4.50.1. Syntaxe
Reference_Syntax.commitOn = "select | exit"
4.50.2. Valeurs
Type Valeurs
Chaîne • select
• exit
Les données sélectionnées sont consignées dans le modèle lorsqu’un utilisateur sélectionne à l’aide du clavier ou de la souris une entrée dans la liste de choix.L’utilisation de données de validation disponibles dès l’étape de la sélection pour une liste à choix multiples peut s’avérer importante dans les formulaires contenant des fonctions interactives non XFA, telles que les liens hypertexte ou les annotations d’Acrobat. Les personnes remplissant de tels formulaires peuvent comprendre à tort que la sélection d’un élément dans une liste à choix multiples suivie d’un clic sur une fonction interactive non XFA revient à quitter la liste. En réalité, la liste est toujours sélectionnée.
• exit
Les données sélectionnées ne sont pas consignées dans le modèle de données tant que le champ n’est pas désélectionné. Il s’agit du paramètre recommandé pour les listes à choix multiples prenant en charge plusieurs sélections (open="multiSelect").
4.50.3. Application
Modèle Objet
Modèle de formulaire choiceList
4.50.4. Version
XFA 2.2
Propriétés de script
4.50.5. Exemples
4.50.6. JavaScript
DropDownList1.resolveNode("ui.#choiceList").commitOn = "exit";
4.50.7. FormCalc
DropDownList1.ui.#choiceList.commitOn = "exit"
4.51. connection
Spécifie le nom du contrôle de connexion associé dans l’ensemble de connexions.
La connexion désignée par cette propriété doit pointer vers un service Web.
4.51.1. Syntaxe
Reference_Syntax.connection = "string"
4.51.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom de l’objet de connexion associé dans l’ensemble de connexions. Si cette propriété est absente ou vide, la connexion prend par défaut le nom du sous-formulaire recevant les données.
4.51.3. Application
Modèle Objet
Modèle de formulaire bindItemsconnectexecutesetProperty
Modèle sourceSet connect
246
Propriétés de script 4
4.51.4. Version
247
XFA 2.4
4.51.5. Exemples
4.51.6. JavaScript
TextField1.resolveNode("#connect").connection = "DataConnection";
4.51.7. FormCalc
TextField1.#connect.connection = "DataConnection"
4.52. contains
Spécifie si une valeur de données doit être incluse dans la valeur de l’objet parent ou en tant que propriété du parent.
4.52.1. Syntaxe
Reference_Syntax.contains = "data | metaData"
4.52.2. Valeurs
Type Valeurs
Chaîne • data(par défaut)
• metadata
La valeur est incluse dans la valeur de l’objet parent.
• metadata
La valeur est une propriété de l’objet parent.
Propriétés de script
4.52.3. Application
Modèle Objet
Modèle de données dataValue
4.52.4. Version
XFA 2.1
4.53. content
Indique le contenu de l’objet.
4.53.1. Syntaxe
Reference_Syntax.content = "string"
4.53.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le contenu de l’objet. Les paquets contenant des données XML doivent renvoyer une chaîne vide.
4.53.3. Application
Modèle Objet
Modèle XFA packet
4.53.4. Version
XFA 2.1
248
Propriétés de script 4
4.53.5. Exemples
4.53.6. JavaScript
249
xfa.packet.content = "";
4.53.7. FormCalc
xfa.packet.content = ""
4.54. contentType
Spécifie le type de contenu présent dans le document référencé, à savoir MIME.
4.54.1. Syntaxe
Reference_Syntax.contentType = "text/plain | application/x-formcalc | Mime-type"
4.54.2. Valeurs
Type Valeurs
Chaîne Les valeurs suivantes sont autorisées pour les documents contenant du texte :
• text/plain(par défaut)
• application/x-formcalc
• Tout identifiant de type MIME valide.
Texte sans ornementation. L’application peut accepter du contenu ne se conformant pas strictement aux conditions du type MIME.
• application/x-formcalc
• Tout identifiant de type MIME valide.
Propriétés de script
Chaîne Un script FormCalc.
• Tout identifiant de type MIME valide.
La prise en charge d’autres types de texte, tels que text/html et types de script, tels que application/s-ecmascript, est définie par l’implémentation.Lorsque le document référencé est une image, un identifiant de type MIME doit être fourni pour cette propriété pour signaler à l’application que le contenu est une image. Après avoir analysé les données image, l’application peut toutefois remplacer la valeur fournie si elle estime que ces données sont de type différent. Les types d’images pris en charge sont déterminés par l’implémentation.
Type Valeurs
4.54.3. Application
Modèle Objet
Modèle de données dataValue
Modèle de formulaire exDataimagescript
Modèle sourceSet bind
4.54.4. Version
XFA 2.1
4.54.5. Exemples
4.54.6. JavaScript
ImageField1.resolveNode("value.#image").contentType = "application/x-formcalc";
4.54.7. FormCalc
ImageField1.value.#image.contentType = "application/x-formcalc"
250
Propriétés de script 4
4.55. context (désapprouvée)
251
Indique l’objet actif, qui est l’objet de départ lors de l’utilisation des méthodes resolveNode et resolveNodes.
4.55.1. Syntaxe
Reference_Syntax.content = "object"
4.55.2. Valeurs
Type Valeurs
Objet L’objet actif.
4.55.3. Application
model, classe classe
4.55.4. Version
XFA 2.1
4.56. count
Indique le nombre actuel d’instances de sous-formulaire sur un formulaire.
4.56.1. Syntaxe
Reference_Syntax.count = "integer"
Propriétés de script
4.56.2. Valeurs
Type Valeurs
Entier • integer
Entier supérieur ou égal à 0 indiquant le nombre d’instances de sous-formulaire sur un formulaire.
4.56.3. Application
Modèle Objet
Modèle de formulaire instanceManager
4.56.4. Version
XFA 2.5
4.56.5. Exemples
4.56.6. JavaScript
Subform1.instanceManager.count;
4.56.7. FormCalc
Subform1.instanceManager.count
252
Propriétés de script 4
4.57. credentialServerPolicy
253
Indique si la vérification de l’état du certificat est nécessaire lorsqu’une signature numérique est signée. L’état du certificat peut être vérifié à l’aide d’une liste de révocation des certificats ou d’une réponse OCSP (Online Certificate Status Protocol).
4.57.1. Syntaxe
Reference_Syntax.credentialServerPolicy = "Optional | Required"
4.57.2. Valeurs
Type Valeurs
Chaîne • Facultatif(par défaut)
• Obligatoire
L’inclusion de la liste de révocation des certificats ou de la réponse OCSP est facultative.
• Obligatoire
L’inclusion de la liste de révocation des certificats ou de la réponse OCSP est obligatoire.
4.57.3. Application
Modèle Objet
Modèle de formulaire certificates
4.57.4. Version
XFA 2.5
Propriétés de script
4.58. crlSign
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.58.1. Syntaxe
Reference_Syntax.crlSign = "Yes | No | empty_string"
4.58.2. Valeurs
Type Valeurs
Chaîne • Yes(par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
4.58.3. Application
Modèle Objet
Modèle de formulaire keyUsage
4.58.4. Version
XFA 2.5
254
Propriétés de script 4
4.59. cSpace
255
Spécifie l’espace colorimétrique.
L’espace colorimétrique par défaut, qui s’avère être l’unique espace autorisé, est sRVB.
4.59.1. Syntaxe
Reference_Syntax.cSpace = "SRGB"
4.59.2. Valeurs
Type Valeurs
Chaîne SRBG(par défaut)Il s’agit de l’unique valeur prise en charge.
4.59.3. Application
Modèle Objet
Modèle de formulaire couleur
4.59.4. Version
XFA 2.1
4.59.5. Exemples
4.59.6. JavaScript
TextField1.border.edge.color.cSpace = "SRGB";
4.59.7. FormCalc
TextField1.border.edge.color.cSpace = "SRGB"
Propriétés de script
4.60. currentPage
Définit la page active d’un document lors de l’exécution.
Les valeurs de page sont calculées sur la base 0, de sorte que la première page d’un document renvoie la valeur 0.
La propriété currentPage est disponible lorsque layout:ready s’exécute sur un client. En revanche, elle n’est pas disponible lorsque layout:ready s’exécute sur le serveur, car l’exécution de la propriété doit être précédée par celle de la mise en page du formulaire.
4.60.1. Syntaxe
Reference_Syntax.currentPage = "integer"
4.60.2. Valeurs
Type Valeurs
Entier Entier valide représentant une page spécifique du document.
4.60.3. Application
Modèle Objet
Modèle Host hostPseudoModel
4.60.4. Version
XFA 2.1
4.60.5. Exemples
4.60.6. JavaScript
xfa.host.currentPage = "2";
256
Propriétés de script 4
4.60.7. FormCalc
257
xfa.host.currentPage = "2"
LIENS CONNEXES :Utilisation de la numérotation des pages et du nombre de pages
4.61. currentRecordNumber
Renvoie le numéro d’enregistrement actif dans la plage des enregistrements contenus dans l’objet actuel dataWindow.
4.61.1. Syntaxe
Reference_Syntax.currentRecordNumber = "integer"
4.61.2. Valeurs
Type Valeurs
Entier Tout nombre entier valide.
4.61.3. Application
Modèle Objet
Modèle de données dataWindow
4.61.4. Exemples
4.61.5. JavaScript
xfa.dataWindow.currentRecordNumber = "2"; // Le troisième enregistrement
4.61.6. FormCalc
xfa.dataWindow.currentRecordNumber = "2" // Le troisième enregistrement
Propriétés de script
4.62. currentValue
Renvoie la valeur de la propriété avant que le delta soit restauré.
4.62.1. Syntaxe
Reference_Syntax.currentValue = "typed object"
4.62.2. Valeurs
Type Valeurs
Dépend du type de propriété L’objet saisi correctement pour la propriété.
4.62.3. Application
Modèle Objet
Modèle de formulaire
4.62.4. Version
XFA 2.1
4.63. cursorLocation
Indique l’emplacement de la bibliothèque de curseurs à utiliser avec le jeu d’enregistrements.
4.63.1. Syntaxe
Reference_Syntax.cursorLocation = "client | server"
258
Propriétés de script 4
4.63.2. Valeurs
259
Type Valeurs
Chaîne • client(par défaut)
• server
La bibliothèque de curseurs est située sur l’ordinateur client.
• server
La bibliothèque de curseurs est située sur le serveur.
4.63.3. Application
Modèle Objet
Modèle sourceSet recordSet
4.63.4. Version
XFA 2.1
4.64. cursorType
Spécifie le type de curseur à utiliser à l’ouverture du jeu d’enregistrements.
4.64.1. Syntaxe
Reference_Syntax.cursorType = "forwardOnly | keyset | dynamic | static | unspe-cified"
Propriétés de script
4.64.2. Valeurs
Type Valeurs
Chaîne • forwardOnly(par défaut)
• keyset
• dynamic
• static
• unspecified
Identique à un curseur statique, mais le défilement ne se fait que vers l’avant. Les performances s’en trouvent améliorées lorsque vous ne devez parcourir un jeu d’enregistrements qu’une seule fois.
• keyset
• dynamic
• static
• unspecified
Semblable à un curseur dynamique, mais les enregistrements ajoutés par d’autres utilisateurs ne sont pas visibles. Les modifications de données effectuées par d’autres utilisateurs sont visibles.
• dynamic
• static
• unspecified
Les ajouts, modifications et suppressions effectués par d’autres utilisateurs sont visibles, et toutes les opérations effectuées dans le jeu d’enregistrements sont autorisées, à l’exception des signets, si le fournisseur ne les prend pas en charge.
• static
• unspecified
Copie statique d’un ensemble d’enregistrements pouvant être utilisée pour rechercher des données ou pour générer des rapports. Les ajouts, les modifications et les suppressions effectués par d’autres utilisateurs ne sont pas visibles.
• unspecified
Le type de curseur n’est pas spécifié.
260
Propriétés de script 4
4.64.3. Application
261
Modèle Objet
Modèle sourceSet recordSet
4.64.4. Version
XFA 2.1
4.65. data
Indique si l’image fournie au widget doit être désignée comme référence ou incorporée.
La propriété data modifie le comportement de l’objet lorsque le formulaire est rempli.
4.65.1. Syntaxe
Reference_Syntax.data = "link | embed"
4.65.2. Valeurs
Type Valeurs
Chaîne • link
• embed
L’image est désignée comme référence URI. Si l’utilisateur fournit le widget avec une URI, l’attribut href de l’objet Image du conteneur est mis à jour pour prendre en compte le nouvel URI. Si l’objet Image précédemment chargé incorporait une image, cette dernière est supprimée de l’objet.
• embed
L’image est incorporée dans l’objet Image du conteneur. Si l’utilisateur fournit le widget avec une URI, l’image référencée par l’URI est incorporée comme contenu de l’objet Image.
Propriétés de script
4.65.3. Application
Modèle Objet
Modèle de formulaire imageEdit
4.65.4. Version
XFA 2.1
4.65.5. Exemples
4.65.6. JavaScript
TextField1.resolveNode("ui.#imageEdit").data = "embed";
4.65.7. FormCalc
TextField1.ui.#textEdit.data = "embed"
4.66. dataColumnCount
Spécifie un nombre facultatif de colonnes de données à coder pour les codes à barres pris en charge. Cette propriété s’applique uniquement aux codes à barres bidimensionnels (2D).
La conception de formulaire doit associer cette propriété à la propriété dataRowCount pour spécifier un code à barres correspondant à un nombre fixe de rangées et de colonnes ; dans le cas contraire, l’analyseur doit utiliser la propriété rowColumnRatio pour déterminer le nombre de lignes et de colonnes. Le modèle ne doit pas fournir la propriété dataColumnCount, à moins que la propriété dataRowCount ne soit également fournie. Lorsque ces propriétés sont utilisées, la taille du code à barres est fixe. Si les données fournies ne remplissent pas le code à barres, ce dernier est complété par des caractères de remplissage.
262
Propriétés de script 4
4.66.1. Syntaxe
263
Reference_Syntax.dataColumnCount = "string"
4.66.2. Valeurs
Type Valeurs
Chaîne Une chaîne valide représentant le nombre de colonnes de données à coder.
4.66.3. Application
Modèle Objet
Modèle de formulaire barcode
4.66.4. Version
XFA 2.1
4.66.5. Exemples
4.66.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").dataColumnCount = "3";
4.66.7. FormCalc
Code11BarCode1.ui.#barcode.dataColumnCount = "3"
Propriétés de script
4.67. dataDescription
Spécifie le nom de la description d’une connexion aux données à utiliser avec un type particulier de connexion aux services Web.
4.67.1. Syntaxe
Reference_Syntax.dataDescription = "string"
4.67.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom d’une description de données à utiliser lors de l’exportation de données.
4.67.3. Application
Modèle Objet
Modèle connectionSet wsdlConnectionxmlConnectionxsdConnection
4.67.4. Version
XFA 2.1
264
Propriétés de script 4
4.68. dataEncipherment
265
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.68.1. Syntaxe
Reference_Syntax.dataEncipherment = "Yes | No | empty_string"
4.68.2. Valeurs
Type Valeurs
Chaîne • Yes (par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
4.68.3. Application
Modèle Objet
Modèle de formulaire keyUsage
4.68.4. Version
XFA 2.5
Propriétés de script
4.69. dataLength
Indique le nombre maximal de caractères de cette instance du code à barres. Cette propriété s’applique uniquement aux codes à barres unidimensionnels.
Pour les codes à barres logiciels, lorsque la propriété moduleWidth n’est pas spécifiée, la propriété-dataLength doit être fournie par la conception de formulaire. Pour les codes à barres logiciels, cette propriété n’est pas prise en compte.
Les données affichées ne sont pas validées. Dans le cas des codes à barres logiciels, l’application permet aux données de dépasser la section du champ affecté. Quant aux codes à barres matériels, le résultat d’un débordement dépend de l’imprimante.
REMARQUE : il n’existe pas de longueur minimale correspondante. Certains formats de codes à barres disposent d’un nombre fixe de symboles et doivent être complétés au besoin à l’aide de caractères de remplissage. D’autres formats, au contraire, admettent un nombre variable de symboles et doivent se terminer après le dernier symbole.
4.69.1. Syntaxe
Reference_Syntax.dataLength = "string"
4.69.2. Valeurs
Type Valeurs
Chaîne Chaîne valable représentant le nombre maximum de caractères pour cette instance de code à barres. Chaque type de code à barres a une longueur par défaut qui lui est propre.
4.69.3. Application
Modèle Objet
Modèle de formulaire barcode
4.69.4. Version
XFA 2.1
266
Propriétés de script 4
4.69.5. Exemples
4.69.6. JavaScript
267
Code11BarCode1.resolveNode("ui.#barcode").dataLength = "10";
4.69.7. FormCalc
Code11BarCode1.ui.#barcode.dataLength = "10"
4.70. dataNode
Obtient le nœud de données auquel est lié un nœud de formulaire après la fusion.
REMARQUE : dataNode est une propriété « get » uniquement et ne peut pas servir à définir (« set ») un nœud de données.
4.70.1. Syntaxe
Reference_Syntax.dataNode = No | "string"
4.70.2. Application
Modèle Objet
Modèle de formulaire sous-formulaireexclGroupfield
4.70.3. Version
XFA 2.1
Propriétés de script
4.70.4. Exemples
4.70.5. JavaScript
Subform.dataNode.saveXML("pretty")
4.70.6. FormCalc
Subform.dataNode.saveXML("pretty")
4.71. dataPrep
Définit le prétraitement appliqué aux données consignées dans le code à barres.
Ce prétraitement n’a aucun impact sur les données contenues dans les modèles d’objet ni sur ce que voit l’utilisateur lorsque le champ est sélectionné dans les contextes interactifs.
REMARQUE : propriété recommandée pour les codes à barres bidimensionnels (2D) uniquement.
4.71.1. Syntaxe
Reference_Syntax.dataPrep = "none | flateCompress"
4.71.2. Valeurs
Type Valeurs
Chaîne • none(par défaut)
• flateCompress
Utilise les données telles qu’elles sont fournies.
• flateCompress
Ecrit un en-tête composé d’un octet avec une valeur décimale de 257, suivi d’un autre octet dont la valeur décimale est 1. Consigne ensuite les données compressées à l’aide de l’algorithme Flate, comme défini par le groupe IETF (Internet Engineering Task Force) dans le document RFC1951. N’utilise pas d’algorithme de prévision.Ne configurez pas cette option avec un type ne pouvant pas coder de données binaires arbitraires.
268
Propriétés de script 4
4.71.3. Application
269
Modèle Objet
Modèle de formulaire barcode
4.71.4. Version
XFA 2.1
4.71.5. Exemples
4.71.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").dataPrep = "flateCompress";
4.71.7. FormCalc
Code11BarCode1.ui.#barcode.dataPrep = "flateCompress"
4.72. dataRowCount
Spécifie un nombre facultatif de rangées de données à coder pour les codes à barres pris en charge. Cette propriété s’applique uniquement aux codes à barres bidimensionnels (2D).
La conception de formulaire peut associer cette propriété à la propriété dataColumnCount pour spécifier un code à barres correspondant à un nombre fixe de rangées et de colonnes. Dans le cas contraire, la propriété rowColumnRatio , ainsi que la longueur réelle des données insérées, déter-minent le nombre de rangées et de colonnes. La propriété dataRowCount n’existe pas si la propriété dataColumnCount n’est pas également disponible. Lorsque ces propriétés sont utilisées, la taille du code à barres est fixe. Si les données fournies ne remplissent pas le code à barres, les cellules restantes sont complétées par des caractères de remplissage.
Propriétés de script
4.72.1. Syntaxe
Reference_Syntax.dataRowCount = "string"
4.72.2. Valeurs
Type Valeurs
Chaîne Une chaîne valide représentant le nombre de rangées de données à coder.
4.72.3. Application
Modèle Objet
Modèle de formulaire barcode
4.72.4. Version
XFA 2.1
4.72.5. Exemples
4.72.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").dataRowCount = "2";
4.72.7. FormCalc
Code11BarCode1.ui.#barcode.dataRowCount = "2"
270
Propriétés de script 4
4.73. db
271
Spécifie la technologie utilisée pour communiquer avec une base de données.
4.73.1. Syntaxe
Reference_Syntax.db = "string"
4.73.2. Valeurs
Type Valeurs
Chaîne ADO.
4.73.3. Application
Modèle Objet
Modèle sourceSet source
4.73.4. Version
XFA 2.1
Propriétés de script
4.74. decipherOnly
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.74.1. Syntaxe
Reference_Syntax.decipherOnly = "Yes | No | empty_string"
4.74.2. Valeurs
Type Valeurs
Chaîne • Yes(par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
4.74.3. Application
Modèle Objet
Modèle de formulaire keyUsage
4.74.4. Version
XFA 2.5
272
Propriétés de script 4
4.75. delayedOpen
273
Spécifie la durée, en secondes, du délai d’ouverture de la source de données une fois la connexion établie.
4.75.1. Syntaxe
Reference_Syntax.delayedOpen = "string"
4.75.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nombre de secondes.
4.75.3. Application
Modèle Objet
Modèle sourceSet command
4.75.4. Version
XFA 2.1
4.75.5. Exemples
Dans ces exemples, Titles désigne le nom de la connexion aux données.
4.75.6. JavaScript
xfa.sourceSet.Titles.connect.delayedOpen = "5";
4.75.7. FormCalc
xfa.sourceSet.Titles.connect.delayedOpen = "5"
Propriétés de script
4.76. delimiter
Sépare les attributs dans la chaîne Pseudo PS.
4.76.1. Syntaxe
Reference_Syntax.delimiter = ", | string"
4.76.2. Valeurs
Type Valeurs
Chaîne • ,(par défaut)
• Une chaîne valide qui sépare les attributs dans la chaîne Pseudo PS.
4.76.3. Application
Modèle Objet
Modèle de formulaire subjectDN
4.76.4. Version
XFA 2.5
274
Propriétés de script 4
4.77. digitalSignature
275
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.77.1. Syntaxe
Reference_Syntax.digitalSignature = "Yes | No | empty_string"
4.77.2. Valeurs
Type Valeurs
Chaîne • Yes(par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
4.77.3. Application
Modèle Objet
Modèle de formulaire keyUsage
4.77.4. Version
XFA 2.5
Propriétés de script
4.78. disable
Désactive l’invite audible.
4.78.1. Syntaxe
Reference_Syntax.disable = "1 | 0"
4.78.2. Valeurs
Type Valeurs
Chaîne • 1(par défaut)
• 0
Une invite audible est générée si le champ n’est pas masqué ou invisible.
• 0
Aucune invite audible n’existe.
4.78.3. Application
Modèle Objet
Modèle de formulaire speak
4.78.4. Version
XFA 2.1
4.78.5. Exemples
4.78.6. JavaScript
TextField1.assist.speak.disable = "0";
276
Propriétés de script 4
4.78.7. FormCalc
277
TextField1.assist.speak.disable = "0"
4.79. disableAll
Active ou désactive les avertissements en matière de validation.
4.79.1. Syntaxe
Reference_Syntax.disable = "1 | 0"
4.79.2. Valeurs
Type Valeurs
Chaîne • 1 (par défaut)
• 0
Les avertissements relatifs à la validation sont désactivés.
• 0
Les avertissements relatifs à la validation sont activés.
4.79.3. Application
Modèle Objet
Modèle de formulaire validate
4.79.4. Version
XFA 2.1
Propriétés de script
4.80. duplexImposition
Contrôle l’orientation de l’image de la page lors de l’impression des deux côtés.
La propriété duplexImposition est utilisée uniquement si la propriété relation de l’objet pageSet est définie sur duplexPaginated.
Le paramètre pageSet de niveau supérieur contrôle l’imposition de toutes les pages recto verso du document
4.80.1. Syntaxe
Reference_Syntax.duplexImposition = "longEdge | shortEdge"
4.80.2. Valeurs
Type Valeurs
Chaîne • longEdge (par défaut)
• Définit l’imposition de la conception de formulaire pour un document portrait lié le long du bord gauche ou un document paysage lié le long du bord supérieur.
• shortEdge
• Définit l’imposition de la conception du formulaire au plus petit côté.
4.80.3. Application
Modèle Objet
Modèle de formulaire pageSet
4.80.4. Version
XFA 3.1
278
Propriétés de script 4
4.81. editValue
279
Indique la valeur d’édition pour le champ.
4.81.1. Syntaxe
Reference_Syntax.editValue = "string"
4.81.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant la valeur modifiée de la propriété.
4.81.3. Application
Modèle Objet
Modèle de formulaire field
4.81.4. Version
XFA 2.1
4.82. embedPDF
Détermine si le fichier PDF doit être inclus aux données.
4.82.1. Syntaxe
Reference_Syntax.embedPDF = "0 | 1"
Propriétés de script
4.82.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
Le fichier PDF est incorporé aux données envoyées.
• 1
Le fichier PDF n’est pas incorporé aux données envoyées. Un URI est envoyé à la place.
4.82.3. Application
Modèle Objet
Modèle de formulaire submit
4.82.4. Version
XFA 2.1
4.82.5. Exemples
4.82.6. JavaScript
Button1.resolveNode("#event.#submit").embedPDF = "1";
4.82.7. FormCalc
Button1.#event.#submit.embedPDF = "1"
280
Propriétés de script 4
4.83. encipherOnly
281
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.83.1. Syntaxe
Reference_Syntax.encipherOnly = "Yes | No | empty_string"
4.83.2. Valeurs
Type Valeurs
Chaîne • Yes(par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
4.83.3. Application
Modèle Objet
Modèle de formulaire keyUsage
4.83.4. Version
XFA 2.5
Propriétés de script
4.84. endChar
Indique un caractère de commande de fin facultatif à ajouter aux données du code à barres.
La propriété endChar n’est pas prise en compte par l’analyseur si le modèle du code à barres ne prend pas en charge le caractère de commande spécifié.
4.84.1. Syntaxe
Reference_Syntax.endChar = "character"
4.84.2. Valeurs
Type Valeurs
Chaîne Caractère de commande valable.
4.84.3. Application
Modèle Objet
Modèle de formulaire barcode
4.84.4. Version
XFA 2.1
4.84.5. Exemples
4.84.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").endChar = "*";
4.84.7. FormCalc
Code11BarCode1.ui.#barcode.endChar = "*"
282
Propriétés de script 4
4.85. eofAction
283
Spécifie l’opération à effectuer si l’enregistrement actif est le dernier du jeu d’enregistrements.
4.85.1. Syntaxe
Reference_Syntax.eofAction = "moveLast | stayEOF | addNew"
4.85.2. Valeurs
Type Valeurs
Chaîne • moveLast(par défaut)
• stayEOF
• addNew
Déplace l’enregistrement actif vers un emplacement situé après le dernier enregistrement.
• stayEOF
• addNew
L’enregistrement actif sera toujours le dernier enregistrement du jeu d’enregistrements.
• addNew
Ajoute un nouvel enregistrement au jeu d’enregistrements.
4.85.3. Application
Modèle Objet
Modèle sourceSet recordSet
4.85.4. Version
XFA 2.1
Propriétés de script
4.86. errorCorrectionLevel
Indique un niveau de correction d’erreur facultatif à appliquer aux codes à barres pris en charge. Cette propriété s’applique uniquement aux codes à barres bidimensionnels (2D).
REMARQUE : dans le cas des types de codes à barres prenant en charge cette propriété, l’analyseur ne tient pas compte de checksum.
4.86.1. Syntaxe
Reference_Syntax.errorCorrectionLevel = "0 | integer"
4.86.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
Pour PDF417, les valeurs admises sont des entiers compris entre 0 et 8 (inclus).
4.86.3. Application
Modèle Objet
Modèle de formulaire barcode
4.86.4. Version
XFA 2.1
4.86.5. Exemples
4.86.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").errorCorrectionLevel = "5";
284
Propriétés de script 4
4.86.7. FormCalc
285
Code11BarCode1.ui.#barcode.errorCorrectionLevel = "5"
4.87. errorText
Renvoie le message de validation du premier test de validation ayant échoué ou une chaîne vide si ce champ a passé avec succès tous les tests de validation.
4.87.1. Syntaxe
Reference_Syntax.errorText = "string"
4.87.2. Valeurs
Type Valeurs
Chaîne Si le champ est valide, errorText sera vide. Si le champ n’est pas valide, errorText contiendra le message de validation pour la validation qui a échoué.
4.87.3. Application
Modèle Objet
Modèle de formulaire field
4.87.4. Version
XFA 2.9
Propriétés de script
4.88. excludeAllCaps
Indique s’il faut ou non appliquer la césure aux mots écrits entièrement en majuscules.
4.88.1. Syntaxe
Reference_Syntax.excludeAllCaps = "0 | 1"
4.88.2. Valeurs
Type Valeurs
Chaîne • 0
• 1
Si vous choisissez 0 et si la valeur de la propriété hyphenate est 1, les mots dont l’initiale est une lettre majuscule peuvent faire l’objet d’une césure.
• 1
Si vous choisissez 1 et si la valeur de la propriété hyphenate est 0, les mots écrits entièrement en lettres capitales ne peuvent pas faire l’objet d’une césure.
4.88.3. Application
Modèle Objet
Modèle de formulaire hyphenation
4.88.4. Version
XFA 2.8
286
Propriétés de script 4
4.89. excludeInitialCap
287
Indique s’il faut ou non appliquer la césure aux mots dont l’initiale est une lettre majuscule.
4.89.1. Syntaxe
Reference_Syntax.excludeInitialCap = "0 | 1"
4.89.2. Valeurs
Type Valeurs
Chaîne • 0
• 1
Lorsque la valeur est0et que la valeur de la propriété hyphenate est 1, les mots dont l’initiale est une lettre majuscule font l’objet d’une césure.
• 1
Lorsque la valeur est1 ou que la valeur de la propriété hyphenate est 0, les mots dont l’initiale est une lettre majuscule ne font pas l’objet d’une césure.
4.89.3. Application
Modèle Objet
Modèle de formulaire hyphenation
4.89.4. Version
XFA 2.8
Propriétés de script
4.90. executeType
Indique s’il faut importer les nouvelles données dans le formulaire existant ou les fusionner dans la conception de formulaire initiale en vue d’obtenir un nouveau formulaire.
4.90.1. Syntaxe
Reference_Syntax.executeType = "import | remerge"
4.90.2. Valeurs
Type Valeurs
Chaîne • Importer(par défaut)
• remerge
Importe les données dans le formulaire actif sans les fusionner dans la conception de formulaire.
• remerge
Fusionne les données du jeu connectionData dans la conception de formulaire. Le processus de fusion crée des sous-formulaires dynamiques (si nécessaire) selon les données renvoyées par le service Web.
4.90.3. Application
Modèle Objet
Modèle de formulaire execute
4.90.4. Version
XFA 2.1
4.90.5. Exemples
4.90.6. JavaScript
Button1.resolveNode("#event.#execute").executeType = "remerge";
288
Propriétés de script 4
4.90.7. FormCalc
289
Button1.#event.#execute.executeType = "remerge"
4.91. fillColor
Valeur de la couleur d’arrière-plan pour ce champ.
Vous devez définir une couleur de remplissage avant de modifier la couleur.
4.91.1. Syntaxe
Reference_Syntax.fillColor = "[0-255], [0-255], [0-255]"
4.91.2. Valeurs
Type Valeurs
Chaîne Pour l’espace colorimétrique SRVB, les valeurs des composantes doivent suivre le format r,v,b, où r est la valeur de la composante rouge, v celle de la composante verte et b celle de la composante bleue. Chaque valeur doit être comprise entre 0 et 255 (inclus). La valeur 255 représente l’intensité d’affichage maximale. Par exemple, 255,0,0 correspond à la couleur rouge.La couleur par défaut varie selon le contexte dans lequel une couleur est utilisée. Elle est déterminée par l’objet qui englobe l’objet de couleur.
4.91.3. Application
Modèle Objet
Modèle de formulaire exclGroupfieldsous-formulaire
4.91.4. Version
XFA 2.1
Propriétés de script
4.91.5. Exemples
4.91.6. JavaScript
TextField1.fillColor = "150,130,33";
4.91.7. FormCalc
TextField1.fillColor = "150,130,33"
LIENS CONNEXES :Modification de la couleur d’arrière-plan
4.92. fontColor
Spécifie la valeur de la couleur de premier plan pour ce champ. Elle équivaut à l’expression font.fill.couleur.value.
La propriété fontColor affecte à la fois la légende et la valeur d’un champ, sauf si la couleur de la légende est paramétrée via un script.
Par exemple, le script this.fontColor="0,0,255"; s’applique à la fois à la légende et à la valeur d’un champ.
Vous ne pouvez pas utiliser la propriété fontColor pour modifier la couleur de la police de la légende de champ. Pour modifier cette dernière, utilisez caption.font.fill.couleur.value.
4.92.1. Syntaxe
Reference_Syntax.fontColor = "[0-255], [0-255], [0-255]"
4.92.2. Valeurs
Type Valeurs
Chaîne Une chaîne valide représentant la couleur de la police.
290
Propriétés de script 4
4.92.3. Application
291
Modèle Objet
Modèle de formulaire field
4.92.4. Version
XFA 2.1
4.92.5. Exemples
4.92.6. JavaScript
TextField1.fontColor = "150,130,33";
4.92.7. FormCalc
TextField1.fontColor = "150,130,33"
4.93. fontHorizontalScale
Met à l’échelle les glyphes de police horizontalement.
4.93.1. Syntaxe
Reference_Syntax.fontHorizontalScale = "[0 à 100]%"
4.93.2. Valeurs
Type Valeurs
Chaîne Pourcentage valide entre 0 et 100.
Propriétés de script
4.93.3. Application
Modèle Objet
Modèle de formulaire font
4.93.4. Version
XFA 2.8
4.93.5. Exemples
4.93.6. JavaScript
TextField1.font.fontHorizontalScale = 50%;
4.93.7. FormCalc
TextField1.font.fontHorizontalScale = 50%
4.94. fontVerticalScale
Met à l’échelle les glyphes de police verticalement.
4.94.1. Syntaxe
Reference_Syntax.fontVerticalScale = "[0 à 100]%"
4.94.2. Valeurs
Type Valeurs
Chaîne Pourcentage valide entre 0 et 100.
292
Propriétés de script 4
4.94.3. Application
293
Modèle Objet
Modèle de formulaire font
4.94.4. Version
XFA 2.8
4.94.5. Exemples
4.94.6. JavaScript
TextField1.font.fontVerticalScale = 50%;
4.94.7. FormCalc
TextField1.font.fontVerticalScale = 50%
4.95. format
Détermine le format à utiliser pour envoyer les données.
4.95.1. Syntaxe
Reference_Syntax.format = "pdfEnvelope | xmlEnvelope"
Propriétés de script
4.95.2. Valeurs
Type Valeurs
Chaîne Pour l’objet encrypt:
• pdfEnvelope
• xmlEnvelope
Ajoute le contenu en cours d’envoi à un document PDF sous la forme d’une pièce jointe chiffrée.
• xmlEnvelope
Chiffre le contenu en cours d’envoi à l’aide de la méthode de chiffrement W3C XML et le place dans une enveloppe XML.
Chaîne Pour l’objet submit:
• xdp(par défaut)
• formdata
Les données sont conditionnées au format XDP.
• formdata
Les données sont conditionnées et codées au format URL selon les spécifications URL (Uniform Resource Locators).
Les données sont conditionnées au format PDF selon les spécifications Adobe PDF.
4.95.3. Application
Modèle Objet
Modèle de formulaire encryptsubmit
4.95.4. Version
XFA 2.1
294
Propriétés de script 4
4.95.5. Exemples
4.95.6. JavaScript
295
Button1.resolveNode("#event.#submit").format = "pdf"
4.95.7. FormCalc
Button1.#event.#submit.format = "pdf"
4.96. formatMessage
Indique la chaîne de message pour la validation du format pour ce champ.
4.96.1. Syntaxe
Reference_Syntax.formatMessage = "string"
4.96.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le message de validation du format.
4.96.3. Application
Modèle Objet
Modèle de formulaire field
4.96.4. Version
XFA 2.1
Propriétés de script
4.96.5. Exemples
4.96.6. JavaScript
TextField1.formatMessage = "Please use the format: LASTNAME, FIRSTNAME";
4.96.7. FormCalc
TextField1.formatMessage = "Please use the format: LASTNAME, FIRSTNAME"
4.97. formattedValue
Indique la valeur formatée pour le champ.
4.97.1. Syntaxe
Reference_Syntax.formattedValue = "string"
4.97.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant la valeur affichée dans le champ avec formatage, notamment les formats et symboles graphiques.
4.97.3. Application
Modèle Objet
Modèle de formulaire field
4.97.4. Version
XFA 2.1
296
Propriétés de script 4
4.97.5. Exemples
4.97.6. JavaScript
297
TextField2.rawValue = TextField1.formattedValue;
4.97.7. FormCalc
TextField2 = TextField1.formattedValue
LIENS CONNEXES :Obtention ou définition des valeurs d’objet
4.98. formatTest
Définit la validation d’une clause d’image.
La propriété formatTest peut être utilisée pour les validations. La propriété formatTest n’est pas évaluée sur des champs Null. La propriété formatTest peut être un contexte évalué pendant la durée de vie d’un formulaire, comme lorsque la cible d’action quitte un champ.
Pour différencier nullTest et scriptTest, utilisez formatTest pour vérifier la valeur du champ en question. Si elle est nulle ou vide, la validation a échoué du fait d’une validation nullTest.
4.98.1. Syntaxe
Reference_Syntax.formatTest = "warning | disabled | error"
Propriétés de script
4.98.2. Valeurs
Type Valeurs
• disabled
• error
• warning(par défaut)
• dismiss : l’utilisateur comprend le message et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend le message, mais choisit de ne pas respecter cette contrainte.
Chaîne N’effectue aucun test. L’objet de formulaire peut posséder une valeur non conforme à la clause d’image. Il est possible de laisser le champ sans valeur non conforme, sans que cela invalide le formulaire.
• error
• warning(par défaut)
• dismiss : l’utilisateur comprend le message et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend le message, mais choisit de ne pas respecter cette contrainte.
Emet un message et refuse les données qui ne tiennent pas dans la clause d’image. L’objet de formulaire doit se conformer à une clause d’image.
• warning(par défaut)
• dismiss : l’utilisateur comprend le message et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend le message, mais choisit de ne pas respecter cette contrainte.
Emet un message si les données ne tiennent pas dans la clause d’image tout en laissant l’utilisateur passer au champ suivant. Le message doit informer l’utilisateur que l’objet de formulaire doit comporter une valeur conforme à la clause d’image. Il doit proposer deux choix :
• dismiss : l’utilisateur comprend le message et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend le message, mais choisit de ne pas respecter cette contrainte.
298
Propriétés de script 4
4.98.3. Application
299
Modèle Objet
Modèle de formulaire validate
4.98.4. Version
XFA 2.1
4.98.5. Exemples
Définissez le modèle de validation si cela n’est pas déjà fait.
4.98.6. JavaScript
TextField1.validate.picture.value = "A9A 9A9"; TextField1.validate.formatTest = "error";
4.98.7. FormCalc
TextField1.validate.picture = "A9A 9A9" TextField1.validate.formatTest = "error"
4.99. fracDigits
Indique le nombre maximum de chiffres (inclusifs) suivant la décimale à capturer et à stocker.
4.99.1. Syntaxe
Reference_Syntax.fracDigits = "2 | integer"
Propriétés de script
4.99.2. Valeurs
Type Valeurs
Chaîne • 2(par défaut)
• Chaîne représentant toute valeur entière valable.
4.99.3. Application
Modèle Objet
Modèle de formulaire decimal
4.99.4. Version
XFA 2.1
4.99.5. Exemples
Le type des données du champ numérique devrait être décimal.
4.99.6. JavaScript
NumericField1.resolveNode("value.#decimal").fracDigits = "3";
4.99.7. FormCalc
NumericField1.value.#decimal.fracDigits = "3"
300
Propriétés de script 4
4.100. from
301
Spécifie le nom original de la colonne dans la source de données.
4.100.1. Syntaxe
Reference_Syntax.from = "string"
4.100.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom de la colonne dans la source à partir de laquelle les données seront associées.
4.100.3. Application
Modèle Objet
Modèle sourceSet map
4.100.4. Version
XFA 2.1
Propriétés de script
4.101. fullText
Représente la valeur pleine (non tronquée) que l’utilisateur colle dans un champ de formulaire.
Il se peut que le texte inséré dans les zones soit tronqué s’il dépasse la zone de contenu autorisée. La propriété fullText mémorise la valeur non tronquée afin de l’utiliser dans des opérations de script.
La valeur de la propriété newContentType détermine le type de contenu de cette propriété.
4.101.1. Syntaxe
Reference_Syntax.fullText = "string"
4.101.2. Valeurs
Type Valeurs
Chaîne Toute valeur de chaîne valable.
4.101.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.101.4. Version
XFA 2.1
4.101.5. Exemples
4.101.6. JavaScript
xfa.event.fullText;
302
Propriétés de script 4
4.101.7. FormCalc
303
xfa.event.fullText
4.102. h
Mesure de la hauteur pour la disposition.
Lorsque la hauteur est spécifiée sous forme de mesure, cette valeur remplace toute plage d’accrois-sement autorisée par les propriétés minH et maxH. Si cette propriété est omise ou définie comme chaîne vide, la plage d’accroissement est définie par les propriétés minH et maxH.
4.102.1. Syntaxe
Reference_Syntax.h = "0in | measurement"
4.102.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.102.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldsous-formulaire
4.102.4. Version
XFA 2.1
Propriétés de script
4.102.5. Exemples
4.102.6. JavaScript
TextField1.h = "2in";
4.102.7. FormCalc
TextField1.h = "2in"
4.103. hAlign
Indique l’alignement de texte horizontal.
4.103.1. Syntaxe
Reference_Syntax.hAlign = "left | center | right | justifyAll | justify | radix"
4.103.2. Valeurs
Type Valeurs
Chaîne • left(par défaut)
• center
• right
• justifyAll
• justify
Aligne sur le bord gauche de la zone disponible.
• center
• right
• justifyAll
• justify
304
Propriétés de script 4
305
Chaîne Centre horizontalement dans la zone disponible.
• right
• justifyAll
• justify
Aligne sur le bord droit de la zone disponible.
• justifyAll
• justify
Justifie toutes les lignes à gauche et à droite afin de remplir la zone disponible.
• justify
Aligne la dernière ligne à gauche et justifie le reste du texte à gauche et à droite.
Type Valeurs
4.103.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldparasous-formulaire
4.103.4. Version
XFA 2.1
4.103.5. Exemples
4.103.6. JavaScript
TextField1.para.hAlign = "right";
4.103.7. FormCalc
TextField1.para.hAlign = "right"
Propriétés de script
4.104. hand
Décrit la justification d’une ligne ou d’un bord.
REMARQUE : si vous souhaitez afficher les données de champ sous forme de peigne, vous devez définir la valeur de la propriété hand de l’objet bordure du champ sur right. Par exemple :
TextField1.border.hand = "right"; // JavaScript TextField1.border.hand = "right" // FormCalc
4.104.1. Syntaxe
Reference_Syntax.hand = "even | left | right"
4.104.2. Valeurs
Type Valeurs
Chaîne • even(par défaut)
• left
• right
Centre la ligne affichée sur le vecteur ou l’arc sous-jacent.
• left
• right
Positionne la ligne affichée juste à gauche du vecteur ou de l’arc sous-jacent, lorsque la trajectoire de la ligne est suivie du début à la fin.
• right
Positionne la ligne affichée juste à droite du vecteur ou de l’arc sous-jacent, lorsque la trajectoire de la ligne est suivie du début à la fin. Vous devez définir cette valeur pour afficher les données de champ à l’aide d’un peigne.
306
Propriétés de script 4
4.104.3. Application
307
Modèle Objet
Modèle de formulaire arcborderlinerectangle
4.104.4. Version
XFA 2.1
4.104.5. Exemples
4.104.6. JavaScript
Line1.resolveNode("value.#line").hand = "left";
4.104.7. FormCalc
Line1.value.#line.hand = "left"
4.105. highlight
Indique l’aspect visuel d’un bouton lorsque celui-ci est activé par un utilisateur. Toutes les valeurs prennent en charge deux états (relâché et enfoncé) à l’exception depush, qui prend en charge trois états (relâché, enfoncé et effleuré).
4.105.1. Syntaxe
Reference_Syntax.highlight="none | inverted | push | outline"
Propriétés de script
4.105.2. Valeurs
Type Valeurs
Chaîne • push(par défaut)
• none
• inverted
• outline
Pour les boutons définis sur le mode de mise en surbrillance "push", il est possible d’attribuer différentes légendes aux autres états de bouton (enfoncé et survol).
4.105.3. Application
Modèle Objet
Modèle de formulaire button
4.105.4. Version
XFA 2.5
4.105.5. Exemples
4.105.6. JavaScript
Button1.resolveNode("ui.#button").highlight = "push";
4.105.7. FormCalc
Button1.ui.#button.highlight = "push"
308
Propriétés de script 4
4.106. href
309
Indique une référence à un fichier ou à une ressource externe.
La propriété transferEncoding ne s’applique pas aux images externes.
4.106.1. Syntaxe
Reference_Syntax.href = "URL"
4.106.2. Valeurs
Type Valeurs
Chaîne Référence HTML valable. Par exemple :
• http://www.adobe.com/data
• ftp://255.255.0.0/dataFiles
4.106.3. Application
Modèle Objet
Modèle de formulaire exDataimage
4.106.4. Version
XFA 2.1
4.106.5. Exemples
4.106.6. JavaScript
ImageField1.resolveNode("value.#image").href = "/E/dev/Logos/adobe.jpg";
Propriétés de script
4.106.7. FormCalc
ImageField1.value.#image.href = "/E/dev/Logos/adobe.jpg"
4.107. hScrollPolicy
Indique si un champ peut défiler horizontalement.
REMARQUE : cette propriété ne s’applique pas aux champs de texte pouvant être ajustés pour contenir des données ou du texte.
4.107.1. Syntaxe
Reference_Syntax.hScrollPolicy = "auto | on | off"
4.107.2. Valeurs
Type Valeurs
Chaîne • auto(par défaut)
• on
• off
Les champs ne contenant qu’une seule ligne défilent horizontalement et les champs à plusieurs lignes défilent verticalement (une barre de défilement verticale s’affiche si besoin est).
• on
• off
Les barres de défilement horizontales s’affichent, même si le texte ou les données dépassent la limite de débordement du champ.
• off
Empêche l’utilisateur de saisir des caractères lorsque la capacité physique du champ est atteinte (délimitée par la largeur de champ). Notez que cette restriction ne s’applique pas aux données de champ.
310
Propriétés de script 4
4.107.3. Application
311
Modèle Objet
Modèle de formulaire dateTimeEditnumericEdittextEdit
4.107.4. Version
XFA 2.5
4.107.5. Exemples
4.107.6. JavaScript
TextField1.resolveNode("ui.#textEdit").hScrollPolicy = "off";
4.107.7. FormCalc
TextField1.ui.#textEdit.hScrollPolicy = "off"
4.108. hyphenate
Indique si la césure est permise ou non.
4.108.1. Syntaxe
Reference_Syntax.hyphenate = "0 | 1"
Propriétés de script
4.108.2. Valeurs
Type Valeurs
Chaîne • 0
• 1
La césure n’est pas autorisée.
• 1
La césure est autorisée.
4.108.3. Application
Modèle Objet
Modèle de formulaire para
4.108.4. Version
XFA 2.8
4.109. id
Spécifie un type d’ID XML générique défini par l’utilisateur.
4.109.1. Syntaxe
Reference_Syntax.id = "string"
4.109.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant une identification XML définie par l’utilisateur.
312
Propriétés de script 4
4.109.3. Application
313
node, classe classe
4.109.4. Version
XFA 2.1
4.110. imagingBBox
Spécifie une région sur le support où le rendu peut être effectué à l’aide de quatre mesures séparées par des virgules correspondant aux axes x et y, à la largeur et à la hauteur.
4.110.1. Syntaxe
Reference_Syntax.bind = "none | x, y, width, height"
4.110.2. Valeurs
Type Valeurs
Chaîne • none(par défaut)
• x, y, width, height
Un rendu peut être effectué sur toute la surface du papier.
• x, y, width, height
Le contenu du sous-formulaire ne peut pas être modifié par l’utilisateur. Un agent utilisateur doit comprendre que le sous-formulaire n’est qu’un conteneur temporaire lors des opérations de séquencement ; vous ne devez pas être autorisé à modifier le contenu de ce sous-formulaire. Le contenu du sous-formulaire peut toutefois être modifié indirectement, par exemple à l’aide d’opérations et de calculs de script.
4.110.3. Application
Modèle Objet
Modèle de formulaire medium
Propriétés de script
4.110.4. Version
XFA 2.1
4.110.5. Exemples
4.110.6. JavaScript
xfa.form.form1.pageSet.Page1.medium = "100, 100, 50, 50";
4.110.7. FormCalc
xfa.form.form1.pageSet.Page1.medium = "100, 100, 50, 50"
4.111. index
Renvoie la position du nœud dans sa collection de nœuds de même nom et compris dans la plage indiquée.
Si le nœud est dépourvu de nom, la position dans sa collection de même classe est renvoyée.
4.111.1. Syntaxe
Reference_Syntax.index = "integer"
4.111.2. Valeurs
Type Valeurs
Entier Entier représentant la position de l’index de base 0 de l’objet actif par rapport aux objets du même nom compris dans une même plage.
4.111.3. Application
tree, classe classe
314
Propriétés de script 4
4.111.4. Version
315
XFA 2.1
4.111.5. Exemples
4.111.6. JavaScript
Subform1.parent.index;
4.111.7. FormCalc
Subform1.parent.index
LIENS CONNEXES :Référence aux objetsManipulation des instances d’un sous-formulaireModification de la couleur d’arrière-plan
4.112. initial
Spécifie le nombre initial d’occurrences pour un sous-formulaire ou un jeu de sous-formulaires. Cette propriété doit être utilisée uniquement pour les formulaires imprimés et statiques.
4.112.1. Syntaxe
Reference_Syntax.initial = "1 | string"
4.112.2. Valeurs
Type Valeurs
Chaîne • 1(par défaut)
• Chaîne valide représentant n’importe quel entier correct.
Propriétés de script
4.112.3. Application
Modèle Objet
Modèle de formulaire occur
4.112.4. Version
XFA 2.1
4.112.5. Exemples
La modification de l’objet occur sur l’événement form:ready survient trop tard dans le cycle de vie du formulaire. Cet objet doit être modifié au niveau de l’événement template:ready. Toutefois, l’événement template:ready n’est pas accessible dans l’interface utilisateur.
4.112.6. JavaScript
Subform1.occur.initial = "3";
4.112.7. FormCalc
Subform1.occur.initial = "3"
4.113. initialNumber
Fournit le numéro de page d’origine pour la première page d’un groupe de pages consécutives qui utilisent le même objet pageSet.
Lorsque vous utilisez des exécutions de numérotation séparées dans un document unique, utilisez initialNumber pour contrôler le numéro initial de chaque exécution. Par exemple, vous pouvez utiliser i - iv pour la table des matières, puis 1 - 27 pour le corps du document.
4.113.1. Syntaxe
Reference_Syntax.initialNumber = "1 | string"
316
Propriétés de script 4
4.113.2. Valeurs
317
Type Valeurs
Chaîne • 1(par défaut)
• Chaîne valide représentant n’importe quelle entier.
4.113.3. Application
Modèle Objet
Modèle de formulaire pageArea
4.113.4. Version
XFA 2.1
4.113.5. Exemples
4.113.6. JavaScript
xfa.form.form1.pageSet.Page1.initialNumber = "4";
4.113.7. FormCalc
xfa.form.form1.pageSet.Page1.initialNumber = "4"
4.114. input
Spécifie un message d’entrée associé à une opération de connexion WSDL particulière.
4.114.1. Syntaxe
Reference_Syntax.d’entrée = "string"
Propriétés de script
4.114.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant un message d’entrée.
4.114.3. Application
Modèle Objet
Modèle connectionSet operation
4.114.4. Version
XFA 2.1
4.115. instanceIndex
Calcule l’index d’un sous-formulaire ou jeu de sous-formulaires en fonction de son emplacement par rapport à d’autres instances du même objet de formulaire.
4.115.1. Syntaxe
Reference_Syntax.instanceIndex = "integer"
4.115.2. Version
2.5
4.115.3. Valeurs
Type Valeurs
Entier Entier valide représentant l’index de base zéro du sous-formulaire ou jeu de sous-formulaire spécifié.
318
Propriétés de script 4
4.115.4. Application
319
Modèle Objet
Modèle de formulaire sous-formulairesubformSet
4.115.5. Version
XFA 2.5
4.116. intact
Spécifie les contraintes liées au maintien d’un objet parent dans un état intact dans une zone de contenu ou une page.
Seuls les objets field et draw basés sur du texte peuvent être divisés dans une zone de contenu ou une page, c’est-à-dire les objets basés sur l’objet textEdit.
4.116.1. Syntaxe
Reference_Syntax.intact = "none | contentArea"
4.116.2. Valeurs
Type Valeurs
Chaîne • none(valeur par défaut pour les objets de sous-formulaires et de champ)
• contentArea(valeur par défaut des objets draw)
C’est l’application de traitement qui détermine si un objet sera rendu intact dans une zone de contenu ou une page. Le sous-formulaire peut être divisé dans une zone de contenu ou une page. Il s’agit de la valeur par défaut lorsque la disposition du conteneur parent est tb, lr-tb ou table. Les objets field et draw ne sont pas divisés si le conteneur parent ne permet pas d’appliquer cette opération à lui-même.
• contentArea(valeur par défaut des objets draw)
L’objet doit obligatoirement être rendu intact au sein d’une zone de contenu. Il s’agit de la valeur par défaut lorsque la disposition du conteneur parent est position ou row.
Propriétés de script
4.116.3. Application
Modèle Objet
Modèle de formulaire keep
4.116.4. Version
XFA 2.1
4.116.5. Exemples
4.116.6. JavaScript
Subform1.keep.intact = "contentArea";
4.116.7. FormCalc
Subform1.keep.intact = "contentArea"
4.117. inverted
Indique si un coin est convexe (les bords sont joints selon la tangente) ou s’il est inversé et prend une forme concave (les bords sont joints à angle droit).
4.117.1. Syntaxe
Reference_Syntax.inverted = "0 | 1"
320
Propriétés de script 4
4.117.2. Valeurs
321
Type Valeurs
Chaîne • 0(par défaut)
• 1
Le coin est convexe.
• 1
Le coin est concave.
4.117.3. Application
Modèle Objet
Modèle de formulaire corner
4.117.4. Version
XFA 2.1
4.117.5. Exemples
4.117.6. JavaScript
TextField1.border.corner.inverted = "1";
4.117.7. FormCalc
TextField1.border.corner.inverted = "1"
Propriétés de script
4.118. isContainer
Indique si l’objet est un objet conteneur.
REMARQUE : cette propriété est en lecture seule.
4.118.1. Syntaxe JavaScript
Reference_Syntax.isContainer = false | true; - or - Reference_Syntax.isContainer = 0 | 1;
4.118.2. Syntaxe FormCalc
Reference_Syntax.isContainer = 0 | 1
4.118.3. Valeurs
Type Valeurs
Booléen • true | 1(par défaut)
• false | 0
L’objet est un type d’objet conteneur.
• false | 0
L’objet n’est pas un type d’objet conteneur.
4.118.4. Application
node, classe classe
4.118.5. Version
XFA 2.1
322
Propriétés de script 4
4.118.6. Exemples
4.118.7. JavaScript
323
TextField1.isContainer;
4.118.8. FormCalc
TextField1.isContainer
4.119. isDefined
Indique si une fenêtre de données valide est actuellement définie.
Une fenêtre de données peut être considérée comme valide si l’index d’enregistrement actif indique un enregistrement dans les données. Une fenêtre de données n’est pas définie s’il n’existe aucun enregistrement ou si l’index d’enregistrement actif s’étend au-delà de la limite de la plage des enregistrements.
REMARQUE : cette propriété est en lecture seule.
4.119.1. Syntaxe JavaScript
Reference_Syntax.isDefined = false | true; - or - Reference_Syntax.isDefined = 0 | 1;
4.119.2. Syntaxe FormCalc
Reference_Syntax.isDefined = 0 | 1
Propriétés de script
4.119.3. Valeurs
Type Valeurs
Booléen • true | 1(par défaut)
• false | 0
La fenêtre de données actuelle est définie.
• false | 0
La fenêtre de données actuelle n’est pas définie.
4.119.4. Application
Modèle Objet
Modèle de données dataWindow
4.119.5. Version
XFA 2.1
4.119.6. Exemples
4.119.7. JavaScript
xfa.dataWindow.isDefined;
4.119.8. FormCalc
$dataWindow.isDefined
324
Propriétés de script 4
4.120. isNull
325
Indique si la valeur de données actuelle est la valeur nulle.
4.120.1. Syntaxe JavaScript
Reference_Syntax.isNull = false | true; - or - Reference_Syntax.isNull = 0 | 1;
4.120.2. Syntaxe FormCalc
Reference_Syntax.isNull = 0 | 1
4.120.3. Valeurs
Type Valeurs
Booléen • true | 1(par défaut)
• false | 0
La valeur de données actuelle est la valeur nulle.
• false | 0
La fenêtre de données actuelle n’est pas la valeur nulle.
4.120.4. Application
node, classe class
Modèle Objet
Modèle de données dataValue
Propriétés de script
4.120.5. Version
XFA 2.1
4.120.6. Exemples
4.120.7. JavaScript
TextField1.isNull = 0;
4.120.8. FormCalc
TextField1.isNull = 0
4.121. join
Indique la forme d’un coin.
4.121.1. Syntaxe
Reference_Syntax.join = "square | round"
4.121.2. Valeurs
Type Valeurs
Chaîne • square(par défaut)
• round
Le coin joignant les bords a la forme d’un angle droit.
• round
Le coin joignant les bords a la forme d’une courbe arrondie.
326
Propriétés de script 4
4.121.3. Application
327
Modèle Objet
Modèle de formulaire corner
4.121.4. Version
XFA 2.1
4.121.5. Exemples
4.121.6. JavaScript
TextField1.border.corner.join = "round";
4.121.7. FormCalc
TextField1.border.corner.join = "round"
4.122. kerningMode
Applique le crénage aux caractères.
4.122.1. Syntaxe
Reference_Syntax.kerningMode = "none | pair"
Propriétés de script
4.122.2. Valeurs
Type Valeurs
Chaîne • none
• pair
Le crénage est désactivé.
• pair
Le crénage est activé. Si le crénage est activé et que l’interlettrage n’équivaut pas à 0, le crénage est appliqué en premier.
4.122.3. Application
Modèle Objet
Modèle de formulaire font
4.122.4. Version
XFA 2.8
4.122.5. Exemples
4.122.6. JavaScript
TextField1.font.kerningMode = "pair";
4.122.7. FormCalc
TextField1.font.kerningMode = "pair"
328
Propriétés de script 4
4.123. keyAgreement
329
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.123.1. Syntaxe
Reference_Syntax.keyAgreement = "Yes | No | empty_string"
4.123.2. Valeurs
Type Valeurs
Chaîne • Yes(par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
4.123.3. Application
Modèle Objet
Modèle de formulaire keyUsage
4.123.4. Version
XFA 2.5
Propriétés de script
4.124. keyCertSign
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.124.1. Syntaxe
Reference_Syntax.keyCertSign = "Yes | No | empty_string"
4.124.2. Valeurs
Type Valeurs
Chaîne • Yes(par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
4.124.3. Application
Modèle Objet
Modèle de formulaire keyUsage
4.124.4. Version
XFA 2.5
330
Propriétés de script 4
4.125. keyDown
331
Détermine si un utilisateur appuie sur une touche fléchée pour effectuer une sélection. Cette propriété est uniquement disponible pour les zones de liste et les listes déroulantes.
4.125.1. Syntaxe
Reference_Syntax.keyDown = "True | False"
4.125.2. Valeurs
Type Valeurs
Chaîne • True(par défaut)• Sélection effectuée à l’aide d’une touche fléchée.• False
• Sélection effectuée sans utiliser de touche fléchée
4.125.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.125.4. Version
XFA 2.1
4.125.5. Exemples
4.125.6. JavaScript
xfa.event.keyDown;
Propriétés de script
4.125.7. FormCalc
xfa.event.keyDown
4.126. keyEncipherment
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.126.1. Syntaxe
Reference_Syntax.keyEnciphement = "Yes | No | empty_string"
4.126.2. Valeurs
Type Valeurs
Chaîne • Yes(par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
4.126.3. Application
Modèle Objet
Modèle de formulaire keyUsage
332
Propriétés de script 4
4.126.4. Version
333
XFA 2.5
4.127. labelRef
Résout une valeur de données pour chaque nœud de données dans le jeu identifié par l’objet ref.
Les valeurs de données sont ensuite utilisées pour remplir les éléments de libellé, tels que <items save='0'>.
La propriété labelRef est une expression de syntaxe de référence relative.
La propriété labelRef est facultative. Vous pouvez définir une liste en n’utilisant qu’un jeu de valeurs sans libellé. Le cas échéant, l’objet rendu utilise des libellés qui prennent par défaut les valeurs actuelles.
4.127.1. Syntaxe
Reference_Syntax.labelRef = "string"
4.127.2. Valeurs
Type Valeurs
Chaîne Chaîne représentant une valeur de données pour chaque nœud du jeu.
4.127.3. Application
Modèle Objet
Modèle de formulaire bindItems
4.127.4. Version
XFA 2.4
Propriétés de script
4.128. ladderCount
Définit le nombre maximum de lignes consécutives auxquelles la césure peut s’appliquer.
4.128.1. Syntaxe
Reference_Syntax.ladderCount = [0..n]
4.128.2. Valeurs
Type Valeurs
Entier Entier valide représentant le nombre de lignes consécutives pouvant être coupées. La valeur par défaut est 2.
4.128.3. Application
Modèle Objet
Modèle de formulaire hyphenation
4.128.4. Version
XFA 2.8
4.129. language
Renvoie la langue de l’application hôte en cours d’exécution.
4.129.1. Syntaxe
Reference_Syntax.language
334
Propriétés de script 4
4.129.2. Valeurs
335
Type Valeurs
Chaîne Chaîne valide représentant la langue de la version de l’ordinateur hôte.
4.129.3. Application
Modèle Objet
Modèle Host hostPseudoModel
4.129.4. Version
XFA 2.1
4.129.5. Exemples
4.129.6. JavaScript
xfa.host.language;
4.129.7. FormCalc
xfa.host.language
4.130. layout
Indique la stratégie de disposition utilisée par cet objet.
4.130.1. Syntaxe
Reference_Syntax.layout = "position | lr-tb | rl-tb | row | table | tb"
Propriétés de script
4.130.2. Valeurs
Type Valeurs
Chaîne • position(par défaut)
• lr-tb
• rl-tb
• row
• table
• tb
Le contenu de la commande est positionné en fonction des informations sur l’emplacement exprimées sur les objets de contenu.
• lr-tb
• rl-tb
• row
• table
• tb
Le contenu de l’objet est réparti de gauche à droite et de haut en bas.
• rl-tb
• row
• table
• tb
Réservé en vue d’une utilisation ultérieure. Le contenu de l’objet est réparti de droite à gauche et de haut en bas.
• row
• table
• tb
336
Propriétés de script 4
337
Chaîne Il s’agit de l’objet intérieur d’un tableau qui représente une ou plusieurs rangées. Les objets contenus dans cet objet sont les cellules du tableau, et leurs hauteur et largeur ne sont pas prises en compte (le cas échéant). Les cellules sont disposées de droite à gauche et chacune d’elles est ajustée à la hauteur de la rangée et à la largeur d’une ou de plusieurs colonnes consécutives.
• table
• tb
Il s’agit de l’objet extérieur d’un tableau. Les propriétés de disposition de chacun de ses sous-formulaires enfant ou groupes d’exclusion doivent être définies sur la rangée. Les rangées du tableau sont disposées de haut en bas.
• tb
Le contenu de l’objet est réparti de haut en bas.
Type Valeurs
4.130.3. Application
Modèle Objet
Modèle de formulaire exclGroupsous-formulaire
4.130.4. Version
XFA 2.1
4.130.5. Exemples
4.130.6. JavaScript
Subform1.layout = "tb";
4.130.7. FormCalc
Subform1.layout = "tb"
LIENS CONNEXES :Référence aux objetsUtilisation de la numérotation des pages et du nombre de pagesDésactivation de tous les champs d’un formulaire
Propriétés de script
4.131. leadDigits
Indique le nombre maximum de chiffres (inclusifs) précédant la décimale à capturer et à stocker.
4.131.1. Syntaxe
Reference_Syntax.leadDigits = "0 | integer"
4.131.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• Chaîne valide représentant n’importe quelle valeur entière.
4.131.3. Application
Modèle Objet
Modèle de formulaire decimal
4.131.4. Version
XFA 2.1
4.131.5. Exemples
Pour ces exemples, le type des données du champ numérique devrait être décimal.
4.131.6. JavaScript
NumericField1.resolveNode("value.#decimal").leadDigits = "2";
4.131.7. FormCalc
NumericField1.value.#decimal.leadDigits = "2"
338
Propriétés de script 4
4.132. leader
339
Indique l’objet sous-formulaire ou subformSet devant être placé en haut d’une zone de contenu ou d’une zone de page.
La propriété leader remplace les propriétés désapprouvées overflowLeader (désapprouvée) et bookendLeader (désapprouvée).
4.132.1. Syntaxe
Reference_Syntax.leader = "string"
4.132.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant l’ID ou l’expression de syntaxe de référence complète d’un sous-formulaire ou d’un jeu de sous-formulaires. La valeur par défaut est une chaîne vide.
4.132.3. Application
Modèle Objet
Modèle de formulaire bookendbreakAfterbreakBeforeoverflow
4.132.4. Version
XFA 2.4
4.132.5. Exemples
4.132.6. JavaScript
Subform1.leader = "xfa.form.form1.Subform2";
Propriétés de script
4.132.7. FormCalc
Subform1.leader = "xfa.form.form1.Subform2"
4.133. leftInset
Indique la taille d’une insertion à gauche.
4.133.1. Syntaxe
Reference_Syntax.leftInset = "0in | measurement"
4.133.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.133.3. Application
Modèle Objet
Modèle de formulaire margin
4.133.4. Version
XFA 2.1
4.133.5. Exemples
4.133.6. JavaScript
Subform1.margin.leftInset = "0.25in";
340
Propriétés de script 4
4.133.7. FormCalc
341
Subform1.margin.leftInset = "0.25in"
4.134. length
Indique le nombre d’objets dans la liste.
REMARQUE : cette propriété est en lecture seule.
4.134.1. Syntaxe
Reference_Syntax.length
4.134.2. Valeurs
Type Valeurs
Entier Entier valide représentant le nombre d’objets.
4.134.3. Application
list, classe
4.134.4. Version
XFA 2.5
4.134.5. Exemples
4.134.6. JavaScript
// Afficher le nombre de nœuds enfant sous le nœud racine. xfa.host.messageBox("Number of nodes under rootNode after appending clone: " + xfa.record.nodes.length);
Propriétés de script
4.134.7. FormCalc
// Afficher le nombre de nœuds enfant sous le nœud racine. xfa.host.messageBox("Number of nodes under rootNode after appending clone: " + xfa.record.nodes.length)
LIENS CONNEXES :Référence aux objetsCréation d’un nœud dans le modèle de donnéesCalcul de totauxModification de la couleur d’arrière-planRemplissage d’une liste déroulanteDésactivation de tous les champs d’un formulaire
4.135. letterSpacing
Définit la limite d’espacement.
4.135.1. Syntaxe
Reference_Syntax.letterSpacing = "[0..100]% | measurement"
4.135.2. Valeurs
Type Valeurs
Chaîne La limite d’espacement peut être l’une des valeurs suivantes :
• Une mesure absolue, exprimée en valeurs et unités numériques. Il n’est pas nécessaire de spécifier une unité pour la valeur zéro.
• Une mesure relative (à la largeur du cadratin de la police).
• Pourcentage correspondant au rapport de largeur du glyphe de la police pour le caractère d’espacement (U+0020). Si la police n’a pas de caractère d’espacement, le pourcentage est appliqué à la largeur du cadratin de la police.
342
Propriétés de script 4
4.135.3. Application
343
Modèle Objet
Modèle de formulaire font
4.135.4. Version
XFA 2.8
4.135.5. Exemples
4.135.6. JavaScript
TextField1.font.letterSpacing = "10%";
4.135.7. FormCalc
TextField1.font.letterSpacing = "10%"
4.136. lineHeight
Indique la hauteur de ligne à appliquer au contenu d’un paragraphe.
Lorsque cette propriété est omise ou configurée comme chaîne vide, la taille de la police détermine la hauteur de la ligne.
4.136.1. Syntaxe
Reference_Syntax.lineHeight = "0pt | measurement"
Propriétés de script
4.136.2. Valeurs
Type Valeurs
Chaîne • 0pt(par défaut)
• Toute mesure valable.
4.136.3. Application
Modèle Objet
Modèle de formulaire para
4.136.4. Version
XFA 2.1
4.136.5. Exemples
4.136.6. JavaScript
TextField1.para.lineHeight = "20pt";
4.136.7. FormCalc
TextField1.para.lineHeight = "20pt"
344
Propriétés de script 4
4.137. lineThrough
345
Indique l’activation d’une ligne simple ou double traversant le texte (propriété également connue sous le nom de texte barré).
4.137.1. Syntaxe
Reference_Syntax.lineThrough = "0 | 1 | 2"
4.137.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
• 2
La police est générée sans que le texte ne soit barré.
• 1
• 2
La police est générée et le texte est barré d’une ligne simple.
• 2
La police est générée et le texte est barré d’une ligne double.
4.137.3. Application
Modèle Objet
Modèle de formulaire font
4.137.4. Version
XFA 2.1
Propriétés de script
4.137.5. Exemples
4.137.6. JavaScript
TextField1.font.lineThrough = "2";
4.137.7. FormCalc
TextField1.font.lineThrough = "2"
4.138. lineThroughPeriod
Contrôle l’aspect de la ligne sur le texte (propriété également connue sous le nom de texte barré).
4.138.1. Syntaxe
Reference_Syntax.lineThroughPeriod = "all | word"
4.138.2. Valeurs
Type Valeurs
Chaîne • all(par défaut)
• word
La ligne rendue doit s’étendre aux sauts de mots.
• word
La ligne rendue doit être interrompue aux sauts de mots.
4.138.3. Application
Modèle Objet
Modèle de formulaire font
346
Propriétés de script 4
4.138.4. Version
347
XFA 2.1
4.138.5. Exemples
4.138.6. JavaScript
TextField1.font.lineThroughPeriod = "word";
4.138.7. FormCalc
TextField1.font.lineThroughPeriod = "word"
4.139. listen
Contrôle si l’objet d’événement réagit aux événements ayant lieu dans le nœud référencé uniquement ou aux événements se produisant dans le nœud référencé et ses descendants.
4.139.1. Syntaxe
Reference_Syntax.listen = "refOnly | refAndDescendents"
4.139.2. Valeurs
Type Valeurs
Chaîne • refOnly(par défaut) : écoute l’événement uniquement sur le conteneur indiqué par la propriété ref.
• refAndDescendents : écoute l’événement alors qu’il se déclenche sur le nœud ref et ses descendants.
Propriétés de script
4.139.3. Application
Modèle Objet
Modèle de formulaire event
4.139.4. Version
XFA 3.0
4.140. locale
Indique la langue, la devise et le format de date/heure à utiliser pour le contenu de l’objet.
Les paramètres régionaux affectent la représentation des données formatées, validées ou normalisées par des clauses d’image. Lorsque cette propriété est absente ou vide, le comportement par défaut est d’hériter des paramètres régionaux de l’objet parent. Si le sous-formulaire extérieur ne spécifie pas de paramètres régionaux, le comportement par défaut est déduit des paramètres régionaux du système d’exploitation. Si aucun paramètre local n’est fourni par le système d’exploitation, la valeur en_US est utilisée.
4.140.1. Syntaxe
Reference_Syntax.locale = "ambient | locale"
4.140.2. Valeurs
Type Valeurs
Chaîne • ambient(par défaut)
• Nom de paramètres régionaux valable, par exemple en_US. Pour obtenir la liste complète des valeurs de paramètres régionaux valables, référez-vous aux spécifications IETF RFC 1766 et ISO 639/ISO 3166.
L’application utilise les paramètres régionaux propres à l’environnement.
• Nom de paramètres régionaux valable, par exemple en_US. Pour obtenir la liste complète des valeurs de paramètres régionaux valables, référez-vous aux spécifications IETF RFC 1766 et ISO 639/ISO 3166.
348
Propriétés de script 4
4.140.3. Application
349
Modèle Objet
Modèle de formulaire drawfieldsous-formulaire
4.140.4. Version
XFA 2.1
4.140.5. Exemples
4.140.6. JavaScript
TextField1.locale = "en_US";
4.140.7. FormCalc
TextField1.locale = "en_US"
4.141. lockType
Indique le type de fonction de verrouillage à utiliser avec la source de données.
4.141.1. Syntaxe
Reference_Syntax.lockType = "unspecified | readOnly | pessimistic | optimistic | batchOptimistic"
Propriétés de script
4.141.2. Valeurs
Type Valeurs
Chaîne • unspecified(par défaut)
• readOnly
• pessimistic
• optimistic
• batchOptimistic
Aucun type de verrouillage n’est précisé.
• readOnly
• pessimistic
• optimistic
• batchOptimistic
Indique que les enregistrements sont en lecture seule. Les données ne peuvent pas être modifiées.
• pessimistic
• optimistic
• batchOptimistic
Les enregistrements sont verrouillés à la source de données immédiatement après la modification.
• optimistic
• batchOptimistic
Les enregistrements sont verrouillés uniquement lorsqu’une mise à jour des données sollicitée par l’utilisateur se produit.
• batchOptimistic
Indique des mises à jour optimistes par lots. Ceci est obligatoire pour le mode de mise à jour par lots.
4.141.3. Application
Modèle Objet
Modèle sourceSet recordSet
350
Propriétés de script 4
4.141.4. Version
351
XFA 2.1
4.141.5. Exemples
Dans ces exemples, Titles désigne le nom de la connexion aux données.
4.141.6. JavaScript
xfa.sourceSet.Titles.nodes.item(1).query.recordSet.lockType = "optimistic";
4.141.7. FormCalc
xfa.sourceSet.Titles.nodes.item(1).query.recordSet.lockType = "optimistic"
4.142. long
Spécifie la longueur du bord long du support. La longueur spécifiée par propriété long doit être supérieure à celle spécifiée par la propriété short .
4.142.1. Syntaxe
Reference_Syntax.long = "0in | measurement"
4.142.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
Propriétés de script
4.142.3. Application
Modèle Objet
Modèle de formulaire medium
4.142.4. Version
XFA 2.1
4.142.5. Exemples
4.142.6. JavaScript
xfa.form.form1.pageSet.Page1.medium.long = "4in";
4.142.7. FormCalc
xfa.form.form1.pageSet.Page1.medium.long = "4in"
4.143. mandatory
Indique la valeur nullTest pour le champ.
4.143.1. Syntaxe
Reference_Syntax.mandatory = "string"
4.143.2. Valeurs
Type Valeurs
Chaîne Une chaîne qui représente la valeur nullTest.
352
Propriétés de script 4
4.143.3. Application
353
Modèle Objet
Modèle de formulaire exclGroupfield
4.143.4. Version
XFA 2.1
4.143.5. Exemples
4.143.6. JavaScript
Textfield1.mandatory = "error";
4.143.7. FormCalc
TextField1.mandatory = "error"
4.144. mandatoryMessage
Indique la chaîne de message obligatoire pour ce champ.
4.144.1. Syntaxe
Reference_Syntax.mandatoryMessage = "string"
4.144.2. Valeurs
Type Valeurs
Chaîne Une chaîne qui représente un message obligatoire.
Propriétés de script
4.144.3. Application
Modèle Objet
Modèle de formulaire exclGroupfield
4.144.4. Version
XFA 2.1
4.144.5. Exemples
4.144.6. JavaScript
Textfield1.mandatoryMessage = "This field is required.";
4.144.7. FormCalc
TextField1.mandatoryMessage = "This field is required."
4.145. marginLeft
Indique la taille du retrait d’un paragraphe à gauche.
4.145.1. Syntaxe
Reference_Syntax.marginLeft = "0in | measurement"
4.145.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
354
Propriétés de script 4
4.145.3. Application
355
Modèle Objet
Modèle de formulaire para
4.145.4. Version
XFA 2.1
4.145.5. Exemples
4.145.6. JavaScript
TextField1.para.marginLeft = "0.5in";
4.145.7. FormCalc
TextField1.para.marginLeft = "0.5in"
4.146. marginRight
Indique la taille du retrait d’un paragraphe à droite.
4.146.1. Syntaxe
Reference_Syntax.marginRight = "0in | measurement"
4.146.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
Propriétés de script
4.146.3. Application
Modèle Objet
Modèle de formulaire para
4.146.4. Version
XFA 2.1
4.146.5. Exemples
4.146.6. JavaScript
TextField1.para.marginRight = "0.5in";
4.146.7. FormCalc
TextField1.para.marginRight = "0.5in"
4.147. mark
Indique la forme à utiliser lors du remplissage d’un objet de case à cocher.
4.147.1. Syntaxe
Reference_Syntax.mark = "default | check | circle | cross | diamond | square | star"
356
Propriétés de script 4
4.147.2. Valeurs
357
Type Valeurs
Chaîne • default(par défaut)
• check
• circle
• cross
• diamond
• square
• star
Les repères par défaut varient selon la forme de l’objet de case à cocher. Une diagonale pour le carré et un cercle plein pour le cercle. Les nouveaux repères sont des symboles basés sur des polices.
• check
• circle
• cross
• diamond
• square
• star
4.147.3. Application
Modèle Objet
Modèle de formulaire checkButton
4.147.4. Version
XFA 2.5
Propriétés de script
4.147.5. Exemples
4.147.6. JavaScript
CheckBox1.resolveNode("ui.#checkButton").mark = "diamond";
4.147.7. FormCalc
CheckBox1.ui.#checkButton.mark = "diamond"
4.148. match
Contrôle le rôle de l’objet encadré lors d’une opération de liaison de données (fusion).
4.148.1. Syntaxe
Reference_Syntax.mark = "once | none | global | dataref"
4.148.2. Valeurs
Type Valeurs
Chaîne • once(par défaut)
• none
• global
• dataRef
Le nœud représentant l’objet encadré est lié à l’un des nœuds du modèle de données conformément aux règles de correspondance standard.
• none
• global
• dataRef
358
Propriétés de script 4
359
Chaîne Le nœud représentant l’objet encadré est transitoire. Il ne sera pas lié à un nœud du modèle de données.
• global
• dataRef
Le champ compris est global. Si les règles de correspondance normales ne permettent pas de trouver de correspondance, le processus de liaison de données recherche les données à lier au champ en dehors de l’enregistrement actif.
• dataRef
Le champ compris se lie au nœud du modèle de données spécifié par la propriété ref.
Type Valeurs
4.148.3. Application
Modèle Objet
Modèle de formulaire bind
Modèle sourceSet bind
4.148.4. Version
XFA 2.1
4.148.5. Exemples
Il est recommandé de définir la propriété globale d’un champ avant de procéder à la fusion.
4.148.6. JavaScript
TextField1.bind.match = "global";
4.148.7. FormCalc
TextField1.bind.match = "global"
Propriétés de script
4.149. max
Indique le nombre maximal d’occurrences du conteneur englobant, ou -1 pour ne définir aucune limite supérieure pour les occurrences.
La propriété max prend par défaut la valeur de la propriété min. Si une propriété min n’est pas indiquée, la valeur par défaut est 1.
4.149.1. Syntaxe
Reference_Syntax.max = "1 | -1 | integer"
4.149.2. Valeurs
Type Valeurs
Chaîne • 1(par défaut)
• -1
• Tout entier valable.
Aucune limite supérieure n’est définie.
• Tout entier valable.
4.149.3. Application
Modèle Objet
Modèle de formulaire instanceManageroccur
Modèle sourceSet recordSet
4.149.4. Version
XFA 2.1
360
Propriétés de script 4
4.149.5. Exemples
4.149.6. JavaScript
361
Subform1.occur.max = "3";
4.149.7. FormCalc
Subform1.occur.max = "3"
4.150. maxChars
Indique le nombre maximal de caractères que cette valeur de texte peut englober.
4.150.1. Syntaxe
Reference_Syntax.maxChars = "0 | integer"
4.150.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• Tout nombre entier valide.
Si aucune valeur n’est définie ou si la propriété est configurée comme une chaîne vide, il n’y a pas de limite.
4.150.3. JavaScript
TextField1.value.text.maxChars = "5";
4.150.4. FormCalc
TextField1.value.text.maxChars = "5"
Propriétés de script
4.151. maxH
Indique la hauteur maximale à des fins de disposition.
La propriété maxH n’est utile que si l’objet de conteneur englobant est extensible et a une propriété h de valeur nulle. Si aucune valeur n’est définie pour cette propriété, cela signifie qu’aucune limite supérieure n’est définie. Si vous indiquez une valeur pour la propriété h, la taille du conteneur ne peut pas augmenter verticalement et cette propriété n’est pas prise en compte.
4.151.1. Syntaxe
Reference_Syntax.maxH = "0in | measurement"
4.151.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.151.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldsous-formulaire
4.151.4. Version
XFA 2.1
362
Propriétés de script 4
4.151.5. Exemples
4.151.6. JavaScript
363
TextField1.maxH = "3in";
4.151.7. FormCalc
TextField1.maxH = "3in"
4.152. maxLength
Spécifie la longueur de contenu maximale autorisée (incluse) ou -1 pour indiquer qu’aucune longueur maximale n’est imposée.
L’interprétation de cette propriété dépend du type de contenu. Dans ce cas, cette propriété spécifie la longueur de contenu maximale autorisée (incluse) dans les caractères. Par exemple, si le type de contenu est text/plain, cette propriété représente le nombre maximal (inclus) de caractères contenus dans le texte brut. De la même façon, si le type de contenu est text/html, cette propriété représente le nombre maximal de caractères du contenu, à l’exception des annotations et des espaces blancs insignifiants.
4.152.1. Syntaxe
Reference_Syntax.maxLength = "-1 | integer"
4.152.2. Valeurs
Type Valeurs
Chaîne • -1(par défaut)
• Tout nombre entier valide.
Propriétés de script
4.152.3. Application
Modèle Objet
Modèle de formulaire exData
4.152.4. Version
XFA 2.1
4.153. maxW
Indique la largeur maximale à des fins de disposition.
Si aucune valeur n’est définie pour cette propriété, cela signifie qu’aucune valeur maximale n’existe. Cette propriété n’est utile que si l’objet de conteneur englobant est extensible et a une propriété w de valeur nulle. Si vous indiquez une valeur pour la propriété w, la taille du conteneur ne peut pas augmenter horizontalement et cette propriété n’est pas prise en compte.
4.153.1. Syntaxe
Reference_Syntax.maxW = "0in | measurement"
4.153.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
364
Propriétés de script 4
4.153.3. Application
365
Modèle Objet
Modèle de formulaire drawexclGroupfieldsous-formulaire
4.153.4. Version
XFA 2.1
4.153.5. Exemples
4.153.6. JavaScript
TextField1.maxW = "3in";
4.153.7. FormCalc
TextField1.maxW = "3in"
4.154. mergeMode
Commandes dont l’algorithme de fusion de données est utilisé pour un sous-formulaire donné.
Les fragments héritent du paramètre mergeMode spécifié par le sous-formulaire racine du document d’hébergement.
Designer définit la propriété mergeMode du sous-formulaire racine sur consumeData, sauf si un modèle ou un schéma contenant les associations est utilisé comme la connexion de données pour le formulaire. Dans ces cas, la propriété mergeMode est définie sur matchTemplate.
4.154.1. Syntaxe
Reference_Syntax.mergeMode = "consumeData | matchTemplate"
Propriétés de script
4.154.2. Valeurs
Type Valeurs
Chaîne • consumeData (par défaut)
• Utilise un algorithme de fusion de données où un seul élément de données peut provoquer la création d’un sous-formulaire unique.
• matchTemplate
• Utilise un algorithme de fusion de données qui prend en charge des modèles de données relationnelles et permet à un seul élément de données de générer une instance unique de plusieurs sous-formulaires. Désactive les fonctions addInstance, removeInstance et moveInstance de l’objet instanceManager.
4.154.3. Application
Modèle Objet
Modèle de formulaire sous-formulaire
4.154.4. Version
XFA 3.1
4.155. min
Indique le nombre minimal d’occurrences du conteneur englobant.
4.155.1. Syntaxe
Reference_Syntax.min = "1 | integer"
366
Propriétés de script 4
4.155.2. Valeurs
367
Type Valeurs
Chaîne • 1(par défaut)
• Tout entier valable.
4.155.3. Application
Modèle Objet
Modèle de formulaire instanceManageroccur
4.155.4. Version
XFA 2.1
4.155.5. Exemples
4.155.6. JavaScript
Subform1.occur.min = "0";
4.155.7. FormCalc
Subform1.occur.min = "0"
LIENS CONNEXES :Manipulation des instances d’un sous-formulaire
Propriétés de script
4.156. minH
Indique la hauteur maximale à des fins de disposition.
La propriété minH n’est utile que si l’objet de conteneur englobant est extensible et a une propriété h de valeur nulle. Si vous indiquez une valeur pour la propriété h, la taille du conteneur ne peut pas augmenter verticalement et cette propriété n’est pas prise en compte.
4.156.1. Syntaxe
Reference_Syntax.minH = "0in | measurement"
4.156.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.156.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldsous-formulaire
4.156.4. Version
XFA 2.1
4.156.5. Exemples
4.156.6. JavaScript
TextField1.minH = "0.5in";
368
Propriétés de script 4
4.156.7. FormCalc
369
TextField1.minH = "0.5in"
4.157. minW
Indique la largeur maximale à des fins de disposition.
La propriété minW n’est utile que si l’objet de conteneur englobant est extensible et a une propriété w de valeur nulle. Si vous indiquez une valeur pour la propriété w, la taille du conteneur ne peut pas augmenter horizontalement et cette propriété n’est pas prise en compte.
4.157.1. Syntaxe
Reference_Syntax.minW = "0in | measurement"
4.157.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.157.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldsous-formulaire
4.157.4. Version
XFA 2.1
Propriétés de script
4.157.5. Exemples
4.157.6. JavaScript
TextField1.minW = "0.5in";
4.157.7. FormCalc
TextField1.minW = "0.5in"
4.158. model
Indique le modèle de l’objet actuel.
REMARQUE : cette propriété est en lecture seule.
4.158.1. Syntaxe
Reference_Syntax.model
4.158.2. Valeurs
Type Valeurs
Objet Objet racine pour le modèle d’objets du formulaire XML, tel que connectionSet ou dataModel.
4.158.3. Application
node, classe classe
4.158.4. Version
XFA 2.1
370
Propriétés de script 4
4.158.5. Exemples
4.158.6. JavaScript
371
xfa.model.name;
4.158.7. FormCalc
xfa.model.name
4.159. modifier
Détermine l’utilisation de la touche de modification (par exemple, Ctrl sous Microsoft Windows®) lors de l’exécution d’un événement particulier.
4.159.1. Syntaxe JavaScript
Reference_Syntax.modifier = false | true; - or - Reference_Syntax.modifier = 0 | 1;
4.159.2. Syntaxe FormCalc
Reference_Syntax.modifier = 0 | 1
4.159.3. Valeurs
Type Valeurs
Booléen • true | 1(par défaut)
• false | 0
Touche de modification enfoncée pendant l’exécution d’un événement.
• false | 0
Touche de modification relâchée pendant l’exécution d’un événement.
Propriétés de script
4.159.4. Application
Modèle Objet
Modèle Event eventPseudoModel
4.159.5. Version
XFA 2.1
4.159.6. Exemples
4.159.7. JavaScript
xfa.event.modifier;
4.159.8. FormCalc
xfa.event.modifier
4.160. moduleHeight
Détermine la hauteur d’une série de barres utilisées pour coder un caractère de texte fourni.
La gamme de hauteurs autorisée dépend des formats de codes à barres. Le modèle de formulaire ne doit pas spécifier de hauteur dépassant la plage autorisée.
4.160.1. Syntaxe
Reference_Syntax.moduleHeight = "5mm | measurement"
372
Propriétés de script 4
4.160.2. Valeurs
373
Type Valeurs
Chaîne • 5 mm(valeur par défaut pour les codes à barres 2D)
• Toute mesure valable.
Lorsque cette propriété n’est pas fournie, le comportement par défaut dépend du type de code à barres. Les codes à barres unidimensionnels atteignent la hauteur d’un champ englobant, limitée par la plage de hauteur autorisée. Les codes à barres 2D prennent par défaut une hauteur de module égale à 5 mm.
4.160.3. Application
Modèle Objet
Modèle de formulaire barcode
4.160.4. Version
XFA 2.1
4.160.5. Exemples
4.160.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").moduleHeight = "5mm";
4.160.7. FormCalc
Code11BarCode1.ui.#barcode.moduleHeight = "5mm"
Propriétés de script
4.161. moduleWidth
Spécifie différents aspects d’un code à barres en fonction de la classe de codes à barres utilisée.
Pour les codes à barres unidimensionnels, l’analyseur utilise la valeur de cette propriété pour définir la largeur des barres les plus étroites. La largeur des barres les plus larges est calculée en fonction de celle des barres les plus étroites. La gamme de largeurs autorisée dépend des formats de codes à barres. Le modèle de formulaire ne doit pas spécifier de valeur dépassant la plage autorisée. Si la propriété moduleWidth est fournie, la propriété dataLength n’est pas prise en compte. À l’inverse, la propriété moduleWidth n’a pas de valeur par défaut. Ainsi, si la propriété dataLength n’est pas fournie, la propriété moduleWidth doit être fournie.
Pour les codes à barres matériels 2D, la propriété moduleWidth n’a aucun effet ou produit le même effet que les codes à barres logiciels, en fonction du type d’imprimante et de code à barres. La plage de valeurs autorisée dépend des imprimantes et des codes à barres.
Pour les codes à barres 2D, la valeur de cette propriété détermine la largeur de module. Un module est une série de barres codant un symbole. En général, un symbole correspond à un caractère de données fournies. La gamme de largeurs autorisée dépend des formats de codes à barres. Le modèle de formulaire ne doit pas spécifier de valeur dépassant la plage autorisée.
4.161.1. Syntaxe
Reference_Syntax.moduleWidth = "0.25mm | measurement"
4.161.2. Valeurs
Type Valeurs
Chaîne • 0.25 mm(par défaut)
• Toute mesure valable.
4.161.3. Application
Modèle Objet
Modèle de formulaire barcode
374
Propriétés de script 4
4.161.4. Version
375
XFA 2.1
4.161.5. Exemples
4.161.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").moduleWidth = "25mm";
4.161.7. FormCalc
Code11BarCode1.ui.#barcode.moduleHeight = "25mm"
4.162. multiLine
Indique si le texte peut couvrir plusieurs lignes.
La propriété multiLine s’avère utile si les clients, tels que les navigateurs HTML, possèdent deux types d’interfaces pour modifier le texte.
4.162.1. Syntaxe
Reference_Syntax.multiLine = "1 | 0"
4.162.2. Valeurs
Type Valeurs
Chaîne • 1(par défaut)
• 0
Le texte peut couvrir plusieurs lignes.
• 0
Le texte est limité à une seule ligne.
Propriétés de script
4.162.3. Application
Modèle Objet
Modèle de formulaire textEdit
4.162.4. Version
XFA 2.1
4.162.5. Exemples
4.162.6. JavaScript
TextField1.resolveNode("ui.#textEdit").multiLine = "0";
4.162.7. FormCalc
TextField1.ui.#textEdit.multiLine = "0"
LIENS CONNEXES :Concaténation de valeurs de données
4.163. name
Identificateur qui permet de désigner un objet ou un événement dans les expressions de script.
Par exemple, cette propriété définit le nom de l’application hôte et, sur un formulaire PDF interactif, renvoie Acrobat.
4.163.1. Syntaxe
Reference_Syntax.name
376
Propriétés de script 4
4.163.2. Valeurs
377
Type Valeurs
Chaîne Chaîne pouvant comprendre jusqu’à 255 caractères.
4.163.3. Application
tree, classe classe
4.163.4. Version
XFA 2.1
4.163.5. Exemples
4.163.6. JavaScript
xfa.host.name;
4.163.7. FormCalc
xfa.host.name
LIENS CONNEXES :Référence aux objetsModification de la couleur d’arrière-plan
Propriétés de script
4.164. newContentType
Indique le type de contenu de la propriété newText.
Par exemple, si newContentType=’text/html’, newText contiendra un fragment XHTML.
4.164.1. Syntaxe
Reference_Syntax.newContentType = "allowRichText | plainTextOnly"
4.164.2. Valeurs
Type Valeurs
Chaîne • allowRichText(par défaut)
• plainTextOnly
Le champ prend en charge le texte enrichi.
• plainTextOnly
Le champ ne prend pas en charge le texte enrichi. Même en présence d’annotations, il vaut mieux transmettre les données que les interpréter. Il n’est toutefois pas garanti que le traitement en aval répondra aux annotations.
4.164.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.164.4. Version
XFA 2.1
378
Propriétés de script 4
4.164.5. Exemples
4.164.6. JavaScript
379
xfa.event.newContentType = "plainTextOnly";
4.164.7. FormCalc
xfa.event.newContentType = "plainTextOnly"
4.165. newText
Indique le contenu du champ une fois qu’il a été modifié suite aux actions de l’utilisateur.
4.165.1. Syntaxe
Reference_Syntax.newText = "string"
4.165.2. Valeurs
Type Valeurs
Chaîne Chaîne pouvant comprendre jusqu’à 255 caractères.
4.165.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.165.4. Version
XFA 2.1
Propriétés de script
4.165.5. Exemples
4.165.6. JavaScript
TextField2.rawValue = xfa.event.newText;
4.165.7. FormCalc
TextField2 = xfa.event.newText
LIENS CONNEXES :Référence aux objetsRemplissage d’une liste déroulante
4.166. next
Indique les contraintes relatives au maintien d’un objet de formulaire avec le conteneur suivant au sein d’une zone de contenu ou d’une page.
4.166.1. Syntaxe
Reference_Syntax.next = "none | contentArea | pageArea"
4.166.2. Valeurs
Type Valeurs
Chaîne • none(par défaut)
• contentArea
• pageArea
Il incombe à l’application de traitement de déterminer si un objet de formulaire est généré dans la même zone de contenu ou sur la même page que le conteneur suivant. Aucune contrainte de maintien particulière ne sera imposée.
380
Propriétés de script 4
381
Chaîne • contentArea
• pageArea
L’objet de formulaire doit obligatoirement être généré dans la même zone de contenu que le conteneur suivant.
• pageArea
L’objet de formulaire doit obligatoirement être généré dans la même page que le conteneur suivant.
Type Valeurs
4.166.3. Application
Modèle Objet
Modèle de formulaire keep
4.166.4. Version
XFA 2.1
4.166.5. Exemples
4.166.6. JavaScript
Subform1.keep.next = "contentArea";
4.166.7. FormCalc
Subform1.keep.next = "contentArea"
Propriétés de script
4.167. nodes
Renvoie une liste de tous les objets enfants de l’objet actuel.
REMARQUE : le formulaire DOM étant rare, les nœuds ne peuvent être générés que lorsqu’on y accède ou lorsqu’ils sont nécessaires. L’accès aux propriétés des nœuds n’est pas une manière précise de déterminer les enfants ou les propriétés d’un objet.
REMARQUE : cette propriété est en lecture seule.
4.167.1. Syntaxe
Reference_Syntax.nodes
4.167.2. Valeurs
Type Valeurs
Objet Une liste de tous les objets de modèle d’objet de formulaire XML.
4.167.3. Application
tree, classe classe
4.167.4. Version
XFA 2.1
4.167.5. Exemples
4.167.6. JavaScript
Subform1.nodes; // Exemple de ligne unique
// Cet exemple affiche les noms des enfants de Subform1 var oNodes = this.nodes; var nodesLength = oNodes.length;
for (var i = 0; i < nodesLength; i++) { xfa.host.messageBox(oNodes.item(i).name) }
382
Propriétés de script 4
4.167.7. FormCalc
383
Subform1.nodes; // Exemple de ligne unique
// Cet exemple affiche les noms des enfants de Subform1 var oNodes = Subform1.nodes var nodesLength = oNodes.length;
for (var i = 0; i < nodesLength; i++) { xfa.host.messageBox(oNodes.item(i).name) }
LIENS CONNEXES :Création d’un nœud dans le modèle de donnéesModification de la couleur d’arrière-planRemplissage d’une liste déroulante
4.168. nonRepudiation
Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.
4.168.1. Syntaxe
Reference_Syntax.nonRepudiation = "Yes | No | empty_string"
4.168.2. Valeurs
Type Valeurs
Chaîne • Yes(par défaut)
• No
• ""
La valeur doit être définie dans le certificat pour pouvoir être acceptée.
• No
• ""
La valeur ne doit pas être définie dans le certificat pour pouvoir être acceptée.
• ""
S’il est spécifié ou non spécifié comme chaîne vide, l’attribut du certificat n’est pas pris en compte.
Propriétés de script
4.168.3. Application
Modèle Objet
Modèle de formulaire keyUsage
4.168.4. Version
XFA 2.5
4.169. ns
Renvoie l’espace de noms correspondant à l’objet.
Si l’objet en question est la racine d’un modèle, cette propriété renvoie l’espace de noms correspondant au modèle.
REMARQUE : cette propriété est en lecture seule.
4.169.1. Syntaxe
Reference_Syntax.ns
4.169.2. Valeurs
Type Valeurs
Objet Chaîne valide représentant l’espace de noms correspondant à l’objet actuel, ou l’espace de noms correspondant au modèle actuel si l’objet racine est l’objet sélectionné.
4.169.3. Application
node, classe classe
4.169.4. Version
XFA 2.1
384
Propriétés de script 4
4.170. nullTest
385
Détermine si un champ est obligatoire dans un formulaire ou s’il peut être laissé vide.
La propriété nullTest peut être utilisée pour les validations. Une validation nullTest n’est évaluée qu’en tant que résultat d’une validation de pré-événement, comme preSubmit, prePrint, preSave ou preExecute, en fonction de la valeur de $config.present.validate ou d’un appel de script explicite de execValidate.
Un conteneur devient non valide suite à l’évaluation du premier test ayant échoué. Un conteneur devient valide si aucun test d’évaluation n’échoue. Un conteneur est valide lorsque qu’aucun test d’évaluation n’est évalué pour ce conteneur. Dans ce contexte de validation, nullTest n’est pas évaluée et il n’y a aucun autre test de validation.
Par exemple, un champ actuellement non valide suite à une validation nullTest peut devenir valide du fait qu’une valeur a été saisie. Le fait de revenir au champ et de saisir une valeur vide ne provoque pas l’exécution automatique de la validation nullTest nullTest ; le champ peut ainsi redevenir valide. Une nouvelle tentative d’envoi du formulaire impliquerait que le champ redevienne non valide en raison de nullTest.
Si la propriété rawValue a une valeur nulle ou vide, la validation nullTest échoue.
4.170.1. Syntaxe
Reference_Syntax.nullTest = "disabled | error | warning"
4.170.2. Valeurs
Type Valeurs
Chaîne • disabled(par défaut)
• error
• warning
• dismiss : l’utilisateur comprend la recommandation et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend la recommandation, mais choisit de ne pas respecter cette contrainte.
Propriétés de script
Chaîne N’effectue pas ce test (par défaut). L’objet de formulaire peut être affecté d’une valeur nulle. Il est possible de laisser le champ sans valeur sans que cela n’affecte la validité du formulaire. Cette valeur désactive le test de validation.
• error
• warning
• dismiss : l’utilisateur comprend la recommandation et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend la recommandation, mais choisit de ne pas respecter cette contrainte.
Génère un message d’erreur et refuse de valider un champ vide. L’objet de formulaire doit être affecté d’une valeur non nulle.
• warning
• dismiss : l’utilisateur comprend la recommandation et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend la recommandation, mais choisit de ne pas respecter cette contrainte.
Génère un message d’avertissement lorsque le champ est vide, mais autorise l’utilisateur à passer au champ suivant. Le message doit informer l’utilisateur que l’objet de formulaire doit, de préférence, être affecté d’une valeur, et propose deux options :
• dismiss : l’utilisateur comprend la recommandation et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend la recommandation, mais choisit de ne pas respecter cette contrainte.
Type Valeurs
4.170.3. Application
Modèle Objet
Modèle de formulaire validate
4.170.4. Version
XFA 2.1
386
Propriétés de script 4
4.170.5. Exemples
4.170.6. JavaScript
387
TextField1.validate.nullTest = "error";
4.170.7. FormCalc
TextField1.validate.nullTest = "error"
4.171. numbered
Spécifie si la zone de page est assimilée à une zone de page numérotée.
Les zones de pages numérotées contribuent à l’incrémentation normale des numéros de pages, alors que cette dernière est absente des pages sans numéros.
4.171.1. Syntaxe
Reference_Syntax.numbered = "auto | none"
4.171.2. Valeurs
Type Valeurs
Chaîne • auto(par défaut)
• none
La zone de page représente une zone de page numérotée. Par conséquent, l’instanciation de la zone de page contribue à l’incrémentation des numéros de la zone de page en cours.
• none
La zone de page ne contribue pas à incrémenter la numérotation de la zone de page en cours.
Propriétés de script
4.171.3. Application
Modèle Objet
Modèle de formulaire pageArea
4.171.4. Version
XFA 2.1
4.171.5. Exemples
4.171.6. JavaScript
xfa.form.form1.pageSet.Page1.numbered = "none";
4.171.7. FormCalc
xfa.form.form1.pageSet.Page1.numbered = "none"
4.172. numberOfCells
Indique le nombre de cellules dessinées pour un champ peigne. Ceci n’est pas affecté par le nombre de caractères dans la valeur du champ.
4.172.1. Syntaxe
Reference_Syntax.numberOfCells = "0 | integer"
388
Propriétés de script 4
4.172.2. Valeurs
389
Type Valeurs
Entier • 0(par défaut)
• integer
Une seule cellule est dessinée pour le champ peigne, ou si la propriété maxChars est définie, le nombre de cellules correspond à la valeur de maxChars.
• integer
Entier valide qui représente le nombre total de cellules dessinées pour le champ peigne.
4.172.3. Application
Modèle Objet
Modèle de formulaire comb
4.172.4. Version
XFA 2.5
4.172.5. Exemples
4.172.6. JavaScript
TextField1.resolveNode("ui.#textEdit.comb").numberOfCells = "6";
4.172.7. FormCalc
TextField1.ui.#textEdit.comb.numberOfCells = "6"
Propriétés de script
4.173. numPages
Renvoie le nombre de pages que compte le document actif.
4.173.1. Syntaxe
Reference_Syntax.numPages
4.173.2. Valeurs
Type Valeurs
Entier Entier valable représentant le nombre total de pages.
4.173.3. Application
Modèle Objet
Modèle Host hostPseudoModel
4.173.4. Version
XFA 2.1
4.173.5. Exemples
4.173.6. JavaScript
xfa.host.numPages;
390
Propriétés de script 4
4.173.7. FormCalc
391
xfa.host.numPages
LIENS CONNEXES :Référence aux objetsUtilisation de la numérotation des pages et du nombre de pagesDésactivation de tous les champs d’un formulaire
4.174. oddOrEven
Indique si une page est paire ou impaire pour la pagination d’un jeu de pages.
4.174.1. Syntaxe
Reference_Syntax.oddOrEven = "any | odd | even"
4.174.2. Valeurs
Type Valeurs
Chaîne • quelconque(par défaut)
• odd
• even
Représente n’importe quelle page dans un document.
• odd
• even
Représente la première page dans un document et toutes les pages consécutives, indépendamment du numérotation de pages.
• even
Représente la deuxième page dans un document et toutes les pages consécutives, indépendamment du numérotation de pages.
Propriétés de script
4.174.3. Application
Modèle Objet
Modèle de formulaire pageArea
4.174.4. Version
XFA 2.5
4.174.5. Exemples
L’expression de syntaxe de référence varie selon l’objet à partir duquel elle est appelée.
4.174.6. JavaScript
xfa.form.form1.pageSet.Page1.oddOrEven = "even";
4.174.7. FormCalc
xfa.form.form1.pageSet.Page1.oddOrEven = "even"
4.175. oneOfChild
Récupère ou définit l’objet enfant dans le cas où un objet parent peut disposer uniquement d’un objet enfant particulier.
4.175.1. Syntaxe
Reference_Syntax.oneOfChild = "object"
4.175.2. Valeurs
Type Valeurs
Objet L’objet enfant.
392
Propriétés de script 4
4.175.3. Application
393
node, classe classe
4.175.4. Version
XFA 2.1
4.175.5. Exemples
4.175.6. JavaScript
TextField1.value.oneOfChild;
4.175.7. FormCalc
TextField1.value.oneOfChild
LIENS CONNEXES :Référence aux objetsConcaténation de valeurs de données
4.176. open
Détermine le moment où la liste à choix multiples est présentée par les applications interactives.
4.176.1. Syntaxe
Reference_Syntax.open = "userControl | onEntry | always | multiSelect"
Propriétés de script
4.176.2. Valeurs
Type Valeurs
Chaîne • userControl(par défaut)
• onEntry
• always
• multiSelect
La liste se déroule lorsque l’utilisateur clique sur un bouton ou effectue le mouvement de souris approprié. Elle disparaît lorsque le curseur la quitte ou qu’un événement d’interface approprié survient.
• onEntry
• always
• multiSelect
La liste se déroule pour la saisie dans le champ. Elle disparaît lorsque le curseur quitte le champ.
• always
• multiSelect
La liste s’affiche lorsque le champ est visible.
• multiSelect
L’utilisateur peut sélectionner plusieurs entrées dans la liste en appuyant sur la touche Maj lorsqu’il effectue sa sélection. La liste de choix multiples s’affiche lorsque le champ est visible.
4.176.3. Application
Modèle Objet
Modèle de formulaire choiceList
4.176.4. Version
XFA 2.1
394
Propriétés de script 4
4.176.5. Exemples
4.176.6. JavaScript
395
DropDownList1.resolveNode("ui.#choiceList").open = "always";
4.176.7. FormCalc
DropDownList1.ui.#choiceList.open = "always"
4.177. operation
Indique l’opération de signature numérique à effectuer en cas d’utilisation conjointe avec l’objet signData ou l’objet avec lequel créer un lien en cas d’utilisation conjointe avec l’objet traverse.
4.177.1. Syntaxe
Reference_Syntax.signData.operation = "sign | verify | clear"
- ou -
Reference_Syntax.traverse.operation = "next | up | down | left | right | back | first"
4.177.2. Valeurs
Type Valeurs
Chaîne Pour les signatures numériques (en utilisant l’objet signData) :
• sign
• verify
• clear
Ajoute une signature XML aux données XML soumises. Cette opération ne modifie pas le document actif de l’application.
• verify
• clear
Propriétés de script
Chaîne Authentifie une signature XML. Si l’authentification échoue, les processus d’envoi sont annulés et l’application affiche un message en indiquant les raisons. L’opération est effectuée avant la création d’une signature ou l’effacement d’un champ de signature.
• clear
Supprime une signature XML, si elle existe, à partir des données XML soumises. Cette opération ne modifie pas le document actif de l’application et est effectuée avant la création d’une signature.
Pour la liaison d’objet (en utilisant l’objet traverse) :
• next(par défaut)
Activée lorsque l’utilisateur appuie sur la touche de tabulation ou saisit le dernier caractère dans un champ à largeur fixe. Toutefois, la même chaîne de liens est également parcourue par le lecteur d’écran pendant la lecture du formulaire. Par défaut, lit de gauche à droite et de haut en basLa chaîne de liens suivants peut inclure des objets standard, mais ces objets ne peuvent pas accepter de cible d’action. Par conséquent, lorsque la cible se déplace vers l’objet de formulaire suivant, la tabulation se poursuit jusqu’au premier objet acceptant la cible d’action. Vous devez vous assurer que la conception de formulaire ne présente pas de boucle sans fin.Cette propriété n’est utilisée que lorsque le conteneur est un sous-formulaire ou un jeu de sous-formulaires. Le lien pointe vers l’objet atteignant la cible d’action lorsque le conteneur est entré. Le conteneur délègue la cible d’action via ce lien. Par défaut, le premier conteneur qui se trouve être un enfant de ce conteneur, de haut en bas et de gauche à droite.
Type Valeurs
4.177.3. Application
Modèle Objet
Modèle connectionSet wsdlConnection
Modèle de formulaire signDatatraverse
4.177.4. Version
XFA 2.4
396
Propriétés de script 4
4.178. orientation
397
Indique l’orientation du support.
4.178.1. Syntaxe
Reference_Syntax.orientation = "portrait | landscape"
4.178.2. Valeurs
Type Valeurs
Chaîne • portrait(par défaut)
• landscape
L’orientation du support place le bord court en haut.
• landscape
L’orientation du support place le bord long en haut.
4.178.3. Application
Modèle Objet
Modèle de formulaire medium
4.178.4. Version
XFA 2.1
4.178.5. Exemples
4.178.6. JavaScript
xfa.form.form1.pageSet.Page1.medium.orientation = "landscape";
Propriétés de script
4.178.7. FormCalc
xfa.form.form1.pageSet.Page1.medium.orientation = "landscape"
4.179. output
Spécifie le message de sortie associé à une opération de connexion WSDL particulière.
4.179.1. Syntaxe
Reference_Syntax.output = "string"
4.179.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le message de sortie.
4.179.3. Application
Modèle Objet
Modèle connectionSet operation
4.179.4. Version
XFA 2.1
4.179.5. Exemples
4.179.6. JavaScript
xfa.connectionSet.DataConnection.operation.output = "Connection successful.";
398
Propriétés de script 4
4.179.7. FormCalc
399
xfa.connectionSet.DataConnection.operation.output = "Connection successful."
4.180. overflowLeader (désapprouvée)
Indique le sous-formulaire à placer en haut de la zone de contenu ou de la page lorsqu’il est activé suite à un débordement.
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir leader.
4.180.1. Syntaxe
Reference_Syntax.overflowLeader = "string"
4.180.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom ou l’expression de syntaxe de référence complète d’un sous-formulaire.
4.180.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)
4.180.4. Version
XFA 2.1
Propriétés de script
4.180.5. Exemples
4.180.6. JavaScript
Subform1.break.overflowLeader = "Subform2";
4.180.7. FormCalc
Subform1.break.overflowLeader = "Subform2"
4.181. overflowTarget (désapprouvée)
Indique la zone de contenu explicite qui servira de cible de transition lorsque la zone de contenu ou la page actuelle sera dépassée.
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir overflow.target.
4.181.1. Syntaxe
Reference_Syntax.overflowTarget = "string"
4.181.2. Valeurs
Type Valeurs
Chaîne Nom ou expression de syntaxe de référence complète d’une zone de contenu.
4.181.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)
4.181.4. Version
XFA 2.1
400
Propriétés de script 4
4.181.5. Exemples
4.181.6. JavaScript
401
Subform1.break.overflowTarget = "xfa.form.form1.pageSet.Page1.Content_Main";
4.181.7. FormCalc
Subform1.break.overflowTarget = "xfa.form.form1.pageSet.Page1.Content_Main"
4.182. overflowTrailer (désapprouvée)
Indique le sous-formulaire à placer au bas de la zone de contenu ou de la page en cas de débordement.
L’espace vertical requis par la fin de débordement doit être réservé.
A compter de la version XFA 2.8, cette propriété est désapprouvée. Voir trailer.
4.182.1. Syntaxe
Reference_Syntax.overflowTrailer = "string"
4.182.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom ou l’expression de syntaxe de référence complète d’un sous-formulaire.
4.182.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)
Propriétés de script
4.182.4. Version
XFA 2.1
4.182.5. Exemples
4.182.6. JavaScript
Subform1.break.overflowTrailer = "Subform2";
4.182.7. FormCalc
Subform1.break.overflowTrailer = "Subform2"
4.183. override
Lorsqu’elle est utilisée avec l’objet calculate, la propriété override indique si le champ autorise les remplacements et désactive ou active les calculs. Lorsqu’elle est utilisée avec l’objet value, la propriété override indique si un remplacement des calculs a eu lieu.
S’il n’y a aucun objet calculate connexe, cette propriété n’a pas d’effet et l’utilisateur peut saisir une valeur dans ce champ.
4.183.1. Syntaxe
Reference_Syntax.override = "error | ignore | disabled | warning"
402
Propriétés de script 4
4.183.2. Valeurs
403
Type Valeurs
• error
• ignore
• disabled
• warning
• Abandonner indique que l’utilisateur souhaite utiliser la valeur calculée.
• Override indique que l’utilisateur a pris connaissance du message, mais a choisi de remplacer la valeur calculée.
Le calcul est activé et l’utilisateur ne peut pas remplacer la valeur calculée. Si l’utilisateur tente de remplacer la valeur calculée, l’application de traitement affiche un message d’erreur. Pour ne pas avoir à créer de messages d’erreur, les concepteurs de formulaires peuvent définir ces champs en lecture seule.Il s’agit de la valeur de remplacement par défaut lorsque l’objet calculate est inclus dans l’objet de conteneur.
• ignore
• disabled
• warning
• Abandonner indique que l’utilisateur souhaite utiliser la valeur calculée.
• Override indique que l’utilisateur a pris connaissance du message, mais a choisi de remplacer la valeur calculée.
Propriétés de script
Chaîne La valeur calculée est celle fournie par défaut. Si l’utilisateur choisit de remplacer la valeur, l’application de traitement autorise l’opération sans afficher de message d’erreur.Il s’agit de la valeur de remplacement par défaut lorsque l’objet calculate est omis dans le conteneur.
• disabled
• warning
• Abandonner indique que l’utilisateur souhaite utiliser la valeur calculée.
• Override indique que l’utilisateur a pris connaissance du message, mais a choisi de remplacer la valeur calculée.
Le calcul est désactivé. Dans un contexte interactif, l’utilisateur peut saisir des informations dans le champ. Cette valeur de remplacement n’a pas d’incidence sur l’opération effectuée par l’utilisateur. La valeur disabled permet à un script d’événement d’activer ou de désactiver dynamiquement un objet calculate.
• warning
• Abandonner indique que l’utilisateur souhaite utiliser la valeur calculée.
• Override indique que l’utilisateur a pris connaissance du message, mais a choisi de remplacer la valeur calculée.
Le calcul est activé et la valeur calculée est préférée aux valeurs saisies par l’utilisateur. Si l’utilisateur remplace la valeur calculée, l’application de traitement affiche un message d’erreur. Le message informe l’utilisateur que l’objet de formulaire doit utiliser une valeur calculée. Deux options sont proposées :
• Abandonner indique que l’utilisateur souhaite utiliser la valeur calculée.
• Override indique que l’utilisateur a pris connaissance du message, mais a choisi de remplacer la valeur calculée.
L’application ne génère pas de message d’avertissement ou d’invites concernant des cibles d’action atteintes par le même objet.
Type Valeurs
4.183.3. Application
Modèle Objet
Modèle de formulaire calculatevalue
404
Propriétés de script 4
4.183.4. Version
405
XFA 2.1
4.183.5. Exemples
4.183.6. JavaScript
TextField1.calculate.override = "disabled";
4.183.7. FormCalc
TextField1.calculate.override = "disabled"
4.184. pagePosition
Indique une position de la page dans un jeu de pages.
4.184.1. Syntaxe
Reference_Syntax.pagePosition = "any | first | last | rest | only"
4.184.2. Valeurs
Type Valeurs
Chaîne • quelconque(par défaut)
• first
• last
• rest
• only
Propriétés de script
Chaîne Représente n’importe quelle page dans un jeu de pages consécutif.
• first
• last
• rest
• only
Représente la première page dans une séquence de pages consécutive.
• last
• rest
• only
Représente la dernière page dans une séquence de pages consécutive.
• rest
• only
Représente n’importe quelle page à l’exception de la première et de la dernière page dans une séquence de pages.
• only
Représente une séquence de page unique.
Type Valeurs
4.184.3. Application
Modèle Objet
Modèle de formulaire pageArea
4.184.4. Version
XFA 2.5
4.184.5. Exemples
L’expression de syntaxe de référence varie selon l’objet à partir duquel elle est appelée.
406
Propriétés de script 4
4.184.6. JavaScript
407
xfa.form.form1.pageSet.Page1.pagePosition = "only";
4.184.7. FormCalc
xfa.form.form1.pageSet.Page1.pagePosition = "only"
4.185. parent
Renvoie l’objet parent de l’objet en cours.
REMARQUE : cette propriété est en lecture seule.
4.185.1. Syntaxe
Reference_Syntax.parent
4.185.2. Valeurs
Type Valeurs
Objet Un modèle d’objet de formulaire XML.
4.185.3. Application
tree, classe classe
4.185.4. Version
XFA 2.1
Propriétés de script
4.185.5. Exemples
4.185.6. JavaScript
TextField1.parent;
4.185.7. FormCalc
TextField1.parent
LIENS CONNEXES :Référence aux objetsManipulation des instances d’un sous-formulaireModification de la couleur d’arrière-plan
4.186. parentSubform
Indique le sous-formulaire (page) parent du champ.
4.186.1. Syntaxe
Reference_Syntax.parentSubform = "string"
4.186.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nom ou l’expression de syntaxe de référence complète de l’objet de sous-formulaire parent.
4.186.3. Application
Modèle Objet
Modèle de formulaire field
408
Propriétés de script 4
4.186.4. Version
409
XFA 2.1
4.186.5. Exemples
4.186.6. JavaScript
TextField1.parentSubform;
4.186.7. FormCalc
TextField1.parentSubform
4.187. passwordChar
Indique le caractère visible à l’écran lorsqu’un utilisateur saisit un mot de passe dans le formulaire.
4.187.1. Syntaxe
Reference_Syntax.passwordChar = "* | character"
4.187.2. Valeurs
Type Valeurs
Chaîne • “*”(astérisque) (valeur par défaut)
• Tout caractère valable.
4.187.3. Application
Modèle Objet
Modèle de formulaire passwordEdit
Propriétés de script
4.187.4. Version
XFA 2.1
4.187.5. Exemples
4.187.6. JavaScript
PasswordField1.resolveNode("ui.#passwordEdit").passwordChar = "*";
4.187.7. FormCalc
PasswordField1.ui.#passwordEdit.passwordChar = "*"
4.188. permissions
Spécifie les droits d’accès accordés pour un formulaire qui inclut la signature de l’auteur.
Pour plus d’informations sur les signatures d’auteur, voir signatureType.
4.188.1. Syntaxe
Reference_Syntax.permissions = "1 | 2 | 3"
4.188.2. Valeurs
Type Valeurs
Chaîne • 1
• 2(par défaut)
• 3
Aucune modification au document n’est autorisée. Toute modification apportée au document invalide la signature.
410
Propriétés de script 4
411
Chaîne • 2(par défaut)
• 3
Les modifications autorisées sont le remplissage de formulaires, la génération d’instances de modèles de page et la signature. Toute autre modification invalide la signature.
• 3
Les modifications autorisées sont celles permises par 2, ainsi que la création d’annotations, la suppression et la modification. Toute autre modification invalide la signature.
Type Valeurs
4.188.3. Application
Modèle Objet
Modèle de formulaire mdp
4.188.4. Version
XFA 2.5
4.189. placement
Indique l’emplacement de la légende.
4.189.1. Syntaxe
Reference_Syntax.placement = "left | right | top | bottom | inline"
Propriétés de script
4.189.2. Valeurs
Type Valeurs
Chaîne • left(par défaut)
• right
• top
• bottom
• insertion
Localise la légende à gauche du contenu.
• right
• top
• bottom
• insertion
Localise la légende à droite du contenu.
• top
• bottom
• insertion
Localise la légende au-dessus du contenu.
• bottom
• insertion
Localise la légende en dessous du contenu.
• insertion
Localise la légende dans le contenu, en le précédant.
4.189.3. Application
Modèle Objet
Modèle de formulaire caption
412
Propriétés de script 4
4.189.4. Version
413
XFA 2.1
4.189.5. Exemples
4.189.6. JavaScript
TextField1.caption.placement = "left";
4.189.7. FormCalc
TextField1.caption.placement = "left"
4.190. platform
Renvoie la plate-forme de l’ordinateur qui exécute le script.
REMARQUE : cette propriété est en lecture seule.
4.190.1. Syntaxe
Reference_Syntax.platform
4.190.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le système d’exploitation. Par exemple, dans le cas d’un formulaire PDF ouvert dans Acrobat, cette propriété renvoie l’une des valeurs suivantes : WIN, MAC ou UNIX.
Propriétés de script
4.190.3. Application
Modèle Objet
Modèle Host hostPseudoModel
4.190.4. Version
XFA 2.1
4.190.5. Exemples
4.190.6. JavaScript
xfa.host.platform;
4.190.7. FormCalc
xfa.host.platform
4.191. posture
Indique le style d’une police.
4.191.1. Syntaxe
Reference_Syntax.posture = "normal | italic"
414
Propriétés de script 4
4.191.2. Valeurs
415
Type Valeurs
Chaîne • normal(par défaut)
• italic
La police présente un style normal.
• italic
La police est mise en italique.
4.191.3. Application
Modèle Objet
Modèle de formulaire font
4.191.4. Version
XFA 2.1
4.191.5. Exemples
4.191.6. JavaScript
TextField1.font.posture = "italic";
4.191.7. FormCalc
TextField1.font.posture = "italic"
Propriétés de script
4.192. presence
Indique si un objet est visible ou non.
4.192.1. Syntaxe
Reference_Syntax.presence = "visible | invisible | hidden | inactive"
4.192.2. Valeurs
Type Valeurs
Chaîne • visible(par défaut)
• L’objet est visible
• invisible
• L’objet est transparent. Bien qu’invisible, il occupe un espace physique.
• hidden
• L’objet est masqué. Le formulaire n’affiche pas l’objet. Ce dernier n’entre pas en compte pour la mise en forme du formulaire.
• inactive
• Ne s’applique qu’aux objets représentant les conteneurs : field, exclGroup, sous-formulaire. Pour tous les autres objets, l’état inactif doit être traité de la même façon que hidden. Le conteneur participe au processus de fusion des données. Les calculs et validations associés dans un conteneur ne doivent pas se déclencher. Tous les événements de traitement associés au conteneur ne doivent pas se produire. Le rendu du conteneur doit le être le même que pour l’état hidden.
• Cette valeur n’est disponible que pour XFA 2.9 et les processeurs plus récents. Les processeurs plus anciens traitent presence="inactive" en tant que presence = "visible".
416
Propriétés de script 4
4.192.3. Application
417
Modèle Objet
Modèle de formulaire bordercaptioncornerdrawedgeexclGroupfieldfillitemssous-formulaire
4.192.4. Version
XFA 2.1
4.192.5. Exemples
4.192.6. JavaScript
TextField1.presence = "hidden";
4.192.7. FormCalc
TextField1.presence = "hidden"
LIENS CONNEXES :Rendre un objet visible ou invisible
Propriétés de script
4.193. preserve
Spécifie les contraintes veuve/orphelin associées au comportement de débordement du contenu au sein du conteneur qui englobe.
4.193.1. Syntaxe
Reference_Syntax.preserve = "0 | integer | all"
4.193.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• integer
• all
Le contenu dépasse la limite de débordement.
• integer
• all
Une valeur sous forme d’entier supérieure à zéro spécifie la quantité minimale de contenu devant franchir la limite de débordement. Par exemple, la valeur d’entier2empêche la création d’une ligne de contenu creuse hors de la limite de débordement ; deux lignes de contenu sont renvoyées hors de ces limites.
• all
Chaque paragraphe de contenu doit être conservé intact et ne peut donc pas dépasser la limite de débordement.
4.193.3. Application
Modèle Objet
Modèle de formulaire para
418
Propriétés de script 4
4.193.4. Version
419
XFA 2.1
4.193.5. Exemples
4.193.6. JavaScript
TextField1.para.preserve = "all";
4.193.7. FormCalc
TextField1.para.preserve = "all"
4.194. prevContentType
Indique le type de contenu de la valeur spécifiée pour la propriété prevText.
Par exemple, si prevContentType='text/html', prevText contient un fragment XHTML.
4.194.1. Syntaxe
Reference_Syntax.prevContentType = "allowRichText | plainTextOnly"
4.194.2. Valeurs
Type Valeurs
Chaîne • allowRichText(par défaut)
• plainTextOnly
Le champ prend en charge le texte enrichi.
• plainTextOnly
Le champ ne prend pas en charge le texte enrichi.
Propriétés de script
4.194.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.194.4. Version
XFA 2.1
4.194.5. Exemples
4.194.6. JavaScript
xfa.event.prevContentType = "plainTextOnly";
4.194.7. FormCalc
xfa.event.prevContentType = "plainTextOnly"
4.195. previous
Indique les contraintes relatives au maintien d’un objet de formulaire avec le conteneur précédent au sein d’une zone de contenu ou d’une page.
4.195.1. Syntaxe
Reference_Syntax.previous = "none | contentArea | pageArea"
420
Propriétés de script 4
4.195.2. Valeurs
421
Type Valeurs
Chaîne • none(par défaut)
• contentArea
• pageArea
Il incombe à l’application de traitement de déterminer si un objet de formulaire est généré dans la même zone de contenu ou sur la même page que l’objet ou le sous-formulaire précédent. Aucune contrainte particulière n’est imposée.
• contentArea
• pageArea
L’objet de formulaire doit obligatoirement être généré dans la même zone de contenu que l’objet ou le sous-formulaire précédent.
• pageArea
L’objet de formulaire doit obligatoirement être généré dans la même page que l’objet ou le sous-formulaire précédent.
4.195.3. Application
Modèle Objet
Modèle de formulaire keep
4.195.4. Version
XFA 2.1
4.195.5. Exemples
4.195.6. JavaScript
Subform1.keep.previous = "contentArea";
Propriétés de script
4.195.7. FormCalc
Subform1.keep.previous = "contentArea"
4.196. prevText
Indique le contenu du champ avant qu’il soit modifié suite aux actions de l’utilisateur.
La valeur prevText peut être rappelée de manière similaire à une fonction d’annulation.
4.196.1. Syntaxe
Reference_Syntax.prevText
4.196.2. Valeurs
Type Valeurs
Chaîne Chaîne pouvant comprendre jusqu’à 255 caractères.
4.196.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.196.4. Version
XFA 2.1
4.196.5. Exemples
4.196.6. JavaScript
xfa.event.prevText;
422
Propriétés de script 4
4.196.7. FormCalc
423
xfa.event.prevText
LIENS CONNEXES :Référence aux objetsRemplissage d’une liste déroulante
4.197. printCheckDigit
Spécifie si les chiffres de contrôle doivent être imprimés dans le texte affichable.
L’analyseur ignore cette propriété si la propriété checksum possède une valeur de0, ou si la propriété checksum possède une valeur de 1 et que le comportement standard du type de code à barres est de ne pas inclure de somme de contrôle.
4.197.1. Syntaxe
Reference_Syntax.printCheckDigit = "0 | 1"
4.197.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
N’imprime pas le chiffre de contrôle dans le texte affichable, mais seulement dans le code à barres lui-même.
• 1
Ajoute le chiffre de contrôle à la fin du texte affichable.
4.197.3. Application
Modèle Objet
Modèle de formulaire barcode
Propriétés de script
4.197.4. Version
XFA 2.1
4.197.5. Exemples
4.197.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").printCheckDigit = "1";
4.197.7. FormCalc
Code11BarCode1.ui.#barcode.printCheckDigit = "1"
4.198. priority
Modifie le chemin de recherche du texte lu. L’objet spécifié dans cette propriété passe au début du chemin de recherche. Les autres objets conservent leur ordre relatif.
4.198.1. Syntaxe
Reference_Syntax.priority = "custom | caption | name | tooltip"
4.198.2. Valeurs
Type Valeurs
Chaîne • personnalisé(par défaut)
• caption
• name
• tooltip
L’ordre de recherche est le suivant : speak, tooltip, caption, nom du conteneur.
424
Propriétés de script 4
425
Chaîne • caption
• name
• tooltip
L’ordre de recherche est le suivant : caption, speak, tooltip, nom du conteneur.
• name
• tooltip
L’ordre de recherche est le suivant : nom du conteneur, speak, tooltip, caption.
• tooltip
L’ordre de recherche est le suivant : tooltip, speak, caption, nom du conteneur.
Type Valeurs
4.198.3. Application
Modèle Objet
Modèle de formulaire speak
4.198.4. Version
XFA 2.1
4.198.5. Exemples
4.198.6. JavaScript
TextField1.assist.speak.priority = "tooltip";
4.198.7. FormCalc
TextField1.assist.speak.priority = "tooltip"
Propriétés de script
4.199. pushCharacterCount
Définit le nombre minimum de groupes de graphèmes (à l’exception des glyphes de césure ajoutés en début de ligne suivante) autorisés dans un suffixe en cas de césure. Si le suffixe est trop court, le candidat est refusé.
4.199.1. Syntaxe
Reference_Syntax.pushCharacterCount = "integer"
4.199.2. Valeurs
Type Valeurs
Entier Entier valide représentant le nombre minimum de groupes de graphèmes. La valeur par défaut est 3.
4.199.3. Application
Modèle Objet
Modèle de formulaire hyphenation
4.199.4. Version
XFA 2.8
426
Propriétés de script 4
4.200. radius
427
Indique le rayon d’un coin.
La propriété radius a toujours un impact sur l’aspect des coins arrondis, mais elle détermine égale-ment la profondeur des coins carrés inversés. Chaque bord est ajusté à partir de ses extrémités selon le rayon du coin, quelles que soient les valeurs des propriétés inverted et join. En général, cela n’a aucune conséquence, car le coin apparaît joint aux bords ajustés. Cependant, si le coin est affecté de la valeur invisible relativement à la propriété presence, l’ajustement des bords est alors visible même s’il s’agit d’un coin carré non inversé.
4.200.1. Syntaxe
Reference_Syntax.radius = "0in | measurement"
4.200.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.200.3. Application
Modèle Objet
Modèle de formulaire corner
4.200.4. Version
XFA 2.1
Propriétés de script
4.200.5. Exemples
4.200.6. JavaScript
TextField1.border.corner.radius = "0.5in";
4.200.7. FormCalc
TextField1.border.corner.radius = "0.5in"
4.201. radixOffset
Spécifie une valeur de décalage pour le point d’ancrage du paragraphe.
4.201.1. Syntaxe
Reference_Syntax.radixOffset = "0in | measurement"
4.201.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.201.3. Application
Modèle Objet
Modèle de formulaire para
4.201.4. Version
XFA 2.1
428
Propriétés de script 4
4.201.5. Exemples
4.201.6. JavaScript
429
NumericField1.para.radixOffset = "0in";
4.201.7. FormCalc
NumericField1.para.radixOffset = "0in"
4.202. rate
Spécifie le pourcentage de motif grisé sur un arrière-plan plein.
La couleur de l’arrière-plan n’est pas spécifiée par l’objet grisé.
4.202.1. Syntaxe
Reference_Syntax.rate = "50 | integer"
4.202.2. Valeurs
Type Valeurs
Chaîne • 50(par défaut)
• Tout nombre entier valide compris entre 0 et 100, où0indique l’absence de grisé visible sur la couleur d’arrière-plan et 100 le masquage complet de la couleur d’arrière-plan par un motif grisé.
Une valeur comprise entre 0 et 100 indique un mélange variable de couleur d’arrière-plan et de motif grisé superposé. Par exemple, un taux de grisé de 50 signale une proportion égale de couleur d’arrière-plan et de motif grisé.
Propriétés de script
4.202.3. Application
Modèle Objet
Modèle de formulaire stipple
4.202.4. Version
XFA 2.1
4.202.5. Exemples
4.202.6. JavaScript
TextField1.border.fill.stipple.rate = "75";
4.202.7. FormCalc
TextField1.border.fill.stipple.rate = "75"
4.203. rawValue
Indique la valeur non formatée de l’objet actuel.
Par exemple, cette propriété renverrait ou définirait la valeur d’un champ.
4.203.1. Syntaxe
Reference_Syntax.rawValue = "value"
430
Propriétés de script 4
4.203.2. Valeurs
431
Type Valeurs
Variable Les valeurs diffèrent selon l’objet de référencement. Ainsi, dans le cas des objets demandant une valeur de couleur, cette propriété indique une liste de valeurs séparées par des virgules pour chaque composante couleur de l’espace colorimétrique sous la forme r, g, b.Sinon, la propriété rawValue d’un objet field est une chaîne représentant la valeur réelle affichée dans le champ ou la valeur liée du champ.
4.203.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfield
4.203.4. Version
XFA 2.1
4.203.5. Exemples
4.203.6. JavaScript
TextField1.rawValue = "Hello";
Propriétés de script
4.203.7. FormCalc
TextField1.rawValue = "Hello"
LIENS CONNEXES :Référence aux objetsCréation d’un nœud dans le modèle de donnéesObtention ou définition des valeurs d’objetUtilisation de la numérotation des pages et du nombre de pagesConcaténation de valeurs de données Calcul de totauxRemplissage d’une liste déroulanteUtilisation des cases d’option et des cases à cocherDétermination de la modification d’un formulaire
4.204. ready
Indique si le processus de disposition du formulaire est terminé et si les tâches de script peuvent commencer.
REMARQUE : cette propriété est en lecture seule.
4.204.1. Syntaxe JavaScript
Reference_Syntax.ready;
4.204.2. Syntaxe FormCalc
Reference_Syntax.ready
432
Propriétés de script 4
4.204.3. Valeurs
433
Type Valeurs
Booléen • true | 1(par défaut)
Le processus de disposition est terminé.
• false | 0
Le processus de disposition n’est pas terminé.
4.204.4. Application
Modèle Objet
Modèle Layout layoutPseudoModel
4.204.5. Version
XFA 2.1
4.204.6. Exemples
4.204.7. JavaScript
xfa.layout.ready;
4.204.8. FormCalc
xfa.layout.ready
Propriétés de script
4.205. recordsAfter
Renvoie le nombre d’enregistrements dans la fenêtre de données après l’enregistrement en cours.
REMARQUE : cette propriété est en lecture seule.
4.205.1. Syntaxe
Reference_Syntax.recordsAfter
4.205.2. Valeurs
Type Valeurs
Entier Tout nombre entier valide compris entre 0 et la valeur d’index du dernier enregistrement dans les données source.
4.205.3. Application
Modèle Objet
Modèle de données dataWindow
4.205.4. Version
XFA 2.1
4.205.5. Exemples
4.205.6. JavaScript
xfa.dataWindow.recordsAfter;
434
Propriétés de script 4
4.205.7. FormCalc
435
xfa.dataWindow.recordsAfter
Pour un exemple de l’utilisation de la propriété recordsAfter en vue de consulter des enregis-trements de données, reportez-vous à l’exemple Browsing records stored in a data file disponible sur ww.adobe.com/go/dev_lc_scripting_samples.
4.206. recordsBefore
Renvoie le nombre d’enregistrements dans la fenêtre de données avant l’enregistrement en cours.
REMARQUE : cette propriété est en lecture seule.
4.206.1. Syntaxe
Reference_Syntax.recordsBefore
4.206.2. Valeurs
Type Valeurs
Entier Tout nombre entier valide compris entre 0 et la valeur d’index du premier enregistrement dans les données source.
4.206.3. Application
Modèle Objet
Modèle de données dataWindow
4.206.4. Version
XFA 2.1
Propriétés de script
4.206.5. Exemples
4.206.6. JavaScript
xfa.dataWindow.recordsBefore;
4.206.7. FormCalc
xfa.dataWindow.recordsBefore
Pour un exemple de l’utilisation de la propriété recordsBefore en vue de consulter des enregis-trements de données, reportez-vous à l’exemple Browsing records stored in a data file disponible sur ww.adobe.com/go/dev_lc_scripting_samples.
4.207. reenter
Indique l’événement enter se produit pour la première fois. La propriété enter se produit chaque fois qu’un utilisateur clique sur un champ.
À chaque fois qu’un utilisateur clique sur un champ, un événement enter est envoyé avec la propriété reenter définie sur false. Si l’utilisateur clique de nouveau sur le champ ou appuie sur la touche Entrée, un autre événement enter est envoyé avec la propriété reenter définie sur true.
4.207.1. Syntaxe JavaScript
Reference_Syntax.reenter = false | true; - or -Reference_Syntax.reenter = 0 | 1;
4.207.2. Syntaxe FormCalc
Reference_Syntax.reenter = 0 | 1
436
Propriétés de script 4
4.207.3. Valeurs
437
Type Valeurs
Booléen • true | 1
• false | 0
L’événement d’entrée est déjà survenu.
• false | 0
L’événement d’entrée est survenu pour la première fois.
4.207.4. Application
Modèle Objet
Modèle Event eventPseudoModel
4.207.5. Version
XFA 2.1
4.207.6. Exemples
4.207.7. JavaScript
xfa.event.reenter = 0;
4.207.8. FormCalc
xfa.event.reenter = 0
Propriétés de script
4.208. ref
Spécifie une expression de syntaxe de référence définissant le nœud dans le modèle de données auquel le conteneur englobant est associé.
4.208.1. Syntaxe
Reference_Syntax.ref = "string"
4.208.2. Valeurs
Type Valeurs
Chaîne Expression de syntaxe de référence valide.
4.208.3. Application
Modèle Objet
Modèle de formulaire bindbindItemsconnecteventitemstraverse
Modèle sourceSet bindconnect
4.208.4. Version
XFA 2.1
438
Propriétés de script 4
4.209. relation
439
Indique les rapports qu’entretiennent les membres du jeu.
REMARQUE : à partir d’Acrobat 8.0, cette propriété est en lecture seule.
4.209.1. Syntaxe
Reference_Syntax.relation (Acrobat 8.x et versions ultérieures)
Reference_Syntax.relation = "ordered | unordered | choice" (Acrobat 7.x et versions antérieures)
4.209.2. Valeurs
Type Valeurs
Chaîne • ordered(par défaut)
• unordered
• choice
Instancie les membres selon l’ordre dans lequel ils ont été déclarés dans la conception de formulaire. Par conséquent, il se peut que le contenu soit à nouveau trié de manière à respecter l’ordre des documents de la conception de formulaire.
• unordered
• choice
Instancie les membres dans l’ordre des données, quel que soit l’ordre dans lequel ils ont été déclarés. Par conséquent, il se peut que le jeu soit à nouveau trié de manière à respecter l’ordre du contenu.
• choice
Les membres s’excluent mutuellement et un seul d’entre eux peut être instancié. Ce sont les données qui déterminent le membre pour lequel une instance doit être générée.
4.209.3. Application
Modèle Objet
Modèle de formulaire subformSet
Propriétés de script
4.209.4. Version
XFA 2.1
4.209.5. Exemples
4.209.6. JavaScript
xfa.form.form1.resolveNode("#subformSet").relation;
4.209.7. FormCalc
xfa.form.form1.#subformSet.relation
4.210. relevant
Contrôle si un objet de formulaire est inclus dans l’opération d’impression.
4.210.1. Syntaxe
Reference_Syntax.relevant = "+print | -print"
4.210.2. Valeurs
Type Valeurs
Chaîne • +print | print(par défaut pour des objets visibles)
Impose l’affichage d’un objet précis à l’impression de formulaire, quel que soit le paramètre de la propriété presence.
• -print(valeur par défaut des objets invisibles ou masqués)
Impose le masquage d’un objet lors de l’impression du formulaire, quel que soit le paramètre de la propriété presence.
440
Propriétés de script 4
4.210.3. Application
441
Modèle Objet
Modèle de formulaire areabordercontentAreadrawexclGroupfieldpageAreapageSetsubformsubformSetvalue
4.210.4. Version
XFA 2.1
4.210.5. Exemples
4.210.6. JavaScript
Button1.relevant = "-print";
4.210.7. FormCalc
Button1.relevant = "-print"
LIENS CONNEXES :Rendre un objet visible ou invisible
Propriétés de script
4.211. remainCharacterCount
Définit le nombre minimum de groupes de graphèmes (à l’exception des glyphes de césure ajoutés en fin de ligne) autorisés dans un préfixe en cas de césure. Si le préfixe est trop court, le candidat est refusé.
4.211.1. Syntaxe
Reference_Syntax.remainCharacterCount = "integer"
4.211.2. Valeurs
Type Valeurs
Entier Entier valide représentant le nombre de groupes de graphèmes. La valeur par défaut est 3.
4.211.3. Application
Modèle Objet
Modèle de formulaire hyphenation
4.211.4. Version
XFA 2.8
442
Propriétés de script 4
4.212. reserve
443
Mesure indiquant la hauteur ou la largeur d’une légende.
L’effet de cette propriété est déterminé par la propriété placement. Lorsque la légende est placée à gauche ou à droite, la propriété reserve indique la hauteur de la zone de la légende. Lorsque la légende est placée au-dessus ou au-dessous, la propriété reserve indique la largeur. Lorsque la légende est placée sur la même ligne, la propriété reserve n’est pas prise en compte.
Si la propriété reserve possède la valeur 0, l’ajustement automatique est activé pour la zone de la légende. La taille de l’objet est ajustée en fonction de la légende.
4.212.1. Syntaxe
Reference_Syntax.reserve = "measurement"
4.212.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.212.3. Application
Modèle Objet
Modèle de formulaire caption
4.212.4. Version
XFA 2.1
Propriétés de script
4.212.5. Exemples
4.212.6. JavaScript
TextField1.caption.reserve = "1.5in";
4.212.7. FormCalc
TextField1.caption.reserve = "1.5in"
4.213. restoreState
Rétablit les nœuds de formulaire d’un formulaire à leur état d’origine, tout en réinitialisant les propriétés visuelles des champs, telles que les modifications apportées aux couleurs des bordures.
4.213.1. Syntaxe
Reference_Syntax.restoreState = "none | manual | auto"
4.213.2. Valeurs
Type Valeurs
Chaîne • none(par défaut) : les informations sur l’état et la restauration ne sont pas enregistrées.
• manuel : les propriétés spécifiques sont enregistrées et restaurées à l’aide des objets de script.
• La somme de contrôle est vérifiée.
• Toutes les informations sur l’état sont restaurées à l’aide de la méthode restore.
• Les valeurs de champ et les remplacements des calculs sont restaurés si la somme de contrôle est correcte.
• auto(valeur par défaut pour les nouveaux formulaires) : enregistre et restaure automatiquement le formulaire à son état d’origine. Lors de l’ouverture d’un formulaire certifié, l’état n’est pas restauré. Sur un formulaire non certifié, la certification du document ne sera pas autorisée.
444
Propriétés de script 4
445
Chaîne • La somme de contrôle est vérifiée.
• Une fois l’étape de fusion terminée, mais avant l’exécution des calculs, chaque nœud de formulaire verra son état restauré à l’aide du modèle de formulaire enregistré, uniquement si la somme de contrôle est correcte.
• Les valeurs de champ et les remplacements des calculs sont restaurés si la somme de contrôle est correcte.
Si le sous-formulaire racine utilise cette valeur, les propriétés suivantes sont enregistrées et restaurées :
• La somme de contrôle est vérifiée.
• Toutes les informations sur l’état sont restaurées à l’aide de la méthode restore.
• Les valeurs de champ et les remplacements des calculs sont restaurés si la somme de contrôle est correcte.
• auto(valeur par défaut pour les nouveaux formulaires) : enregistre et restaure automatiquement le formulaire à son état d’origine. Lors de l’ouverture d’un formulaire certifié, l’état n’est pas restauré. Sur un formulaire non certifié, la certification du document ne sera pas autorisée.
• La somme de contrôle est vérifiée.
• Une fois l’étape de fusion terminée, mais avant l’exécution des calculs, chaque nœud de formulaire verra son état restauré à l’aide du modèle de formulaire enregistré, uniquement si la somme de contrôle est correcte.
• Les valeurs de champ et les remplacements des calculs sont restaurés si la somme de contrôle est correcte.
La propriété auto ne peut pas être utilisé pour les documents certifiés.Si le sous-formulaire racine utilise cette valeur, les propriétés suivantes sont enregistrées et restaurées :
• La somme de contrôle est vérifiée.
• Une fois l’étape de fusion terminée, mais avant l’exécution des calculs, chaque nœud de formulaire verra son état restauré à l’aide du modèle de formulaire enregistré, uniquement si la somme de contrôle est correcte.
• Les valeurs de champ et les remplacements des calculs sont restaurés si la somme de contrôle est correcte.
Type Valeurs
Propriétés de script
4.213.3. Application
Modèle Objet
Modèle de formulaire sous-formulaire
4.213.4. Version
XFA 2.5
4.213.5. Exemples
4.213.6. JavaScript
Subform1.restoreState = "auto";
4.213.7. FormCalc
Subform1.restoreState = "auto"
4.214. rightInset
Indique la taille d’une insertion à droite.
4.214.1. Syntaxe
Reference_Syntax.rightInset = "0in | measurement"
4.214.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
446
Propriétés de script 4
4.214.3. Application
447
Modèle Objet
Modèle de formulaire margin
4.214.4. Version
XFA 2.1
4.214.5. Exemples
4.214.6. JavaScript
Subform1.margin.rightInset = "0.25in";
4.214.7. FormCalc
Subform1.margin.rightInset = "0.25in"
4.215. role
Indique le rôle joué par le conteneur parent.
4.215.1. Syntaxe
Reference_Syntax.role = "string"
Propriétés de script
4.215.2. Valeurs
Type Valeurs
Chaîne Chaîne valable indiquant le rôle du conteneur parent. Elle peut être employée dans les applications de traitement XFA dont la fonction vocale est activée en vue de fournir des informations. Par exemple, il peut s’agir de valeurs attribuées empruntées au code HTML, telles que TH (en-têtes de tableau) et TR (rangées de tableau).
4.215.3. Application
Modèle Objet
Modèle de formulaire assist
4.215.4. Version
XFA 2.2
4.215.5. Exemples
4.215.6. JavaScript
TextField1.assist.role = "TH";
4.215.7. FormCalc
TextField1.assist.role = "TH"
448
Propriétés de script 4
4.216. rotate
449
Fait pivoter l’objet autour de son point d’ancrage selon l’angle indiqué.
L’angle est exprimé en degrés par rapport à la position par défaut, dans le sens inverse des aiguilles d’une montre. La valeur doit être un multiple non négatif de 90.
REMARQUE : Le sens de la rotation est identique à celui des angles positifs aux formats PostScript®, PDF et PCL, mais inverse pour le format SVG.
4.216.1. Syntaxe
Reference_Syntax.rotate = "0 | measurement"
4.216.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• Toute mesure d’angle valable.
4.216.3. Application
Modèle Objet
Modèle de formulaire drawfield
4.216.4. Version
XFA 2.1
4.216.5. Exemples
4.216.6. JavaScript
TextField1.rotate = "90";
Propriétés de script
4.216.7. FormCalc
TextField1.rotate = "90"
4.217. rowColumnRatio
Un rapport facultatif rangées/colonnes pour les codes à barres 2D pris en charge.
L’analyseur ignore cette propriété si les propriétés dataRowCount et dataColumnCount sont indiquées.
Lorsque rowColumnRatio est fournie, la taille du code à barres évolue pour prendre en compte le nombre de rangées nécessaire à l’affichage des données fournies. Si la dernière rangée n’est pas remplie par les données fournies, elle est complétée par des caractères de remplissage.
4.217.1. Syntaxe
Reference_Syntax.rowColumnRatio = "string"
4.217.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le rapport rangées/colonnes.
4.217.3. Application
Modèle Objet
Modèle de formulaire barcode
4.217.4. Version
XFA 2.1
450
Propriétés de script 4
4.218. runAt
451
Indique quelle application peut exécuter le script.
Tenez compte de ces éléments lorsque vous spécifiez l’application pouvant exécuter un script :
• Le paramètre runAt est appliqué même si le script est appelé par un autre script.
• Les scripts des formulaires destinés à être imprimés sont exécutés sur le serveur même lorsque vous précisez qu’ils doivent l’être sur le client.
• L’événement preSubmit ne s’exécute pas dans des formulaires interactifs et des formulaires destinés à l’impression lorsque vous précisez que le script doit être exécuté sur le serveur.
4.218.1. Syntaxe
Reference_Syntax.runAt = "client | server | both"
4.218.2. Valeurs
Type Valeurs
Chaîne • client(par défaut)
• server
• both
Le script est exécuté sur le client uniquement.
• server
• both
Le script est exécuté sur le serveur uniquement.
• both
Le script est exécuté sur le client et le serveur.
Propriétés de script
4.218.3. Application
Modèle Objet
Modèle de formulaire executescript
4.218.4. Version
XFA 2.1
4.218.5. Exemples
4.218.6. JavaScript
NumericField1.calculate.script.runAt = "both";
4.218.7. FormCalc
NumericField1.calculate.script.runAt = "both"
4.219. save
Détermine si les valeurs d’une colonne particulière désignent à la fois les valeurs d’affichage et liées, ou si les données de la colonne désignent les valeurs liées uniquement.
4.219.1. Syntaxe
Reference_Syntax.save = "0 | 1"
452
Propriétés de script 4
4.219.2. Valeurs
453
Type Valeurs
Chaîne • 0(par défaut)
• 1
Les valeurs fournies par cet objet sont celles d’affichage uniquement.
• 1
Les valeurs fournies par cet objet peuvent être saisies dans ce champ.Au moins une colonne doit contenir la valeur 1. Si plusieurs colonnes possèdent la valeur 1, l’analyseur enregistre la première colonne affichant la valeur de 1 qu’il détecte.
4.219.3. Application
Modèle Objet
Modèle de formulaire items
4.219.4. Version
XFA 2.1
4.219.5. Exemples
4.219.6. JavaScript
DropDownList1.resolveNode("#items").save = "1";
4.219.7. FormCalc
DropDownList1.#items.save = "1"
Propriétés de script
4.220. savedValue
Renvoie un objet saisi mais vous ne pouvez pas affecter cette valeur. Si la propriété n’est pas enregistrée, la valeur est identique à currentValue.
4.220.1. Syntaxe
Reference_Syntax.savedValue = "typed object"
4.220.2. Valeurs
Type Valeurs
Dépend du type de propriété L’objet saisi pour la propriété.
4.220.3. Application
Modèle Objet
Modèle de formulaire
4.220.4. Version
XFA 2.5
4.221. scope
Contrôle l’intervention du sous-formulaire dans la liaison de données et les expressions de syntaxe de référence. Valide uniquement sur le sous-formulaire racine.
Par défaut, un sous-formulaire nommé prend part à la liaison de données et peut être référencé à l’aide d’une expression de syntaxe de référence. Cette propriété permet d’attribuer un nom à un sous-formulaire, mais ne joue aucun rôle dans la liaison de données et les expressions de syntaxe de référence.
454
Propriétés de script 4
4.221.1. Syntaxe
455
Reference_Syntax.scope = "name | none"
4.221.2. Valeurs
Type Valeurs
Chaîne • name(par défaut)
• none
Si le sous-formulaire porte un nom, il prend part à la liaison de données et aux expressions de syntaxe de référence. Dans le cas contraire, il ne joue aucun rôle.
• none
Le sous-formulaire ne prend pas part à la liaison de données ni aux expressions de syntaxe de référence, même s’il porte un nom.
4.221.3. Application
Modèle Objet
Modèle de formulaire sous-formulaire
4.221.4. Version
XFA 2.1
4.221.5. Exemples
4.221.6. JavaScript
Subform1.scope = "none";
4.221.7. FormCalc
Subform1.scope = "none"
Propriétés de script
4.222. scriptTest
Contrôle la validation effectuée par le script inclus.
Il est préférable que les scripts indiqués comme faisant partie de la validation n’établissent aucune supposition sur l’utilisation des résultats de la validation par l’application de traitement ou du moment où l’objet validate est appelé. En particulier, il est vivement déconseillé de définir un script tentant de répondre à un utilisateur ou tentant de modifier l’état du formulaire de quelque façon que ce soit.
La propriété scriptTest peut être utilisée pour les validations. La propriété scriptTest n’est pas évaluée sur des champs Null. La propriété scriptTest peut être un contexte évalué pendant la durée de vie d’un formulaire, comme lorsque la cible d’action quitte un champ.
4.222.1. Syntaxe
Reference_Syntax.scriptTest = "error | disabled | warning"
4.222.2. Valeurs
Type Valeurs
Chaîne • disabled
• error(par défaut)
• warning
• dismiss : l’utilisateur comprend le message et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend le message, mais choisit de ne pas respecter cette contrainte.
N’effectue pas ce test. L’objet de formulaire peut avoir une valeur non conforme au script. Il est possible de laisser le champ doté d’une valeur non conforme sans que cela affecte la validité du formulaire. Cette valeur désactive le test de validation.
• error(par défaut)
• warning
• dismiss : l’utilisateur comprend le message et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend le message, mais choisit de ne pas respecter cette contrainte.
456
Propriétés de script 4
457
Chaîne Envoie un message et refuse les données signalées par le script comme étant erronées. L’objet de formulaire doit avoir une valeur conforme au script.
• warning
• dismiss : l’utilisateur comprend le message et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend le message, mais choisit de ne pas respecter cette contrainte.
Emet un message si le script signale des données erronées tout en permettant à l’utilisateur de passer au champ suivant. Le message doit informer l’utilisateur qu’il est recommandé pour un objet de formulaire de disposer d’une valeur conforme aux contraintes du script et offrir deux choix :
• dismiss : l’utilisateur comprend le message et souhaite revenir au formulaire afin de satisfaire à cette contrainte.
• override : l’utilisateur comprend le message, mais choisit de ne pas respecter cette contrainte.
Type Valeurs
4.222.3. Application
Modèle Objet
Modèle de formulaire validate
4.222.4. Version
XFA 2.1
4.222.5. Exemples
4.222.6. JavaScript
NumericField1.validate.scriptTest = "disabled";
4.222.7. FormCalc
NumericField1.validate.scriptTest = "disabled"
Propriétés de script
4.223. selectedIndex
Index du premier élément sélectionné.
Le choix de cette propriété permet de définir l’index spécifié et de désélectionner tout élément préa-lablement sélectionné. Si vous souhaitez conserver l’état de sélection multiple, utilisez les méthodes getItemState ou setItemState. La spécification d’une valeur d’index de -1 permet d’effacer la liste. L’obtention de cette propriété renvoie une valeur de -1 lorsqu’aucun élément n’est sélectionné.
4.223.1. Syntaxe
Reference_Syntax.selectedIndex
4.223.2. Version
2.5
4.223.3. Valeurs
Type Valeurs
Entier Entier valide représentant la valeur d’index du premier élément sélectionné.La spécification d’une valeur d’index de -1 permet d’effacer la liste. La spécification d’une autre valeur correcte entraîne la sélection de cet élément uniquement.
4.223.4. Application
Modèle Objet
Modèle de formulaire field
4.223.5. Version
XFA 2.5
458
Propriétés de script 4
4.224. selEnd
459
Indique la position de l’index pour le dernier caractère de la sélection de texte stockée dans la propriété prevText lors d’un événement de modification.
4.224.1. Syntaxe
Reference_Syntax.selEnd
4.224.2. Valeurs
Type Valeurs
Entier Entier valide représentant la valeur d’index de base 0 du dernier caractère de la sélection de texte.Si aucun texte n’est sélectionné, cette propriété désigne la position du curseur de saisie de texte au moment du changement. La modification de la valeur de cette propriété a pour effet de modifier les caractères à remplacer par la valeur de changement et repositionne le curseur de saisie de texte.
4.224.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.224.4. Version
XFA 2.1
4.224.5. Exemples
4.224.6. JavaScript
xfa.event.selEnd;
4.224.7. FormCalc
xfa.event.selEnd
Propriétés de script
4.225. selStart
Indique la position de l’index pour le premier caractère de la sélection de texte stockée dans la propriété prevText lors d’un événement de modification.
4.225.1. Syntaxe
Reference_Syntax.selStart
4.225.2. Valeurs
Type Valeurs
Entier Entier valide représentant la valeur d’index de base 0 du premier caractère de la sélection de texte.Si aucun texte n’est sélectionné, cette propriété désigne la position du curseur de saisie de texte au moment du changement. La modification de la valeur de cette propriété a pour effet de modifier les caractères à remplacer par la valeur de changement et repositionne le curseur de saisie de texte.
4.225.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.225.4. Version
XFA 2.1
4.225.5. Exemples
4.225.6. JavaScript
xfa.event.selStart;
4.225.7. FormCalc
460
xfa.event.selStart
Propriétés de script 4
4.226. server
461
Indique l’URL pour un serveur de tampons temporels.
4.226.1. Syntaxe
Reference_Syntax.server = "string"
4.226.2. Valeurs
Type Valeurs
Chaîne Chaîne valide qui représente l’URL pour un serveur de tampons temporels.
4.226.3. Application
Modèle Objet
Modèle de formulaire timeStamp
4.226.4. Version
XFA 2.5
4.227. shape
Indique si le contour de la case à cocher ou du bouton radio est carré ou rond.
4.227.1. Syntaxe
Reference_Syntax.shape = "square | round"
Propriétés de script
4.227.2. Valeurs
Type Valeurs
Chaîne • square(par défaut)
• round
Le bouton s’affiche avec un contour carré.
• round
Le bouton s’affiche avec un contour rond.
4.227.3. Application
Modèle Objet
Modèle de formulaire checkButton
4.227.4. Version
XFA 2.1
4.227.5. Exemples
4.227.6. JavaScript
CheckButton1.resolveNode("ui.#checkButton").shape = "square";
4.227.7. FormCalc
CheckButton.ui.#checkButton.shape = "square"
462
Propriétés de script 4
4.228. shift
463
Indique si la touche Maj est enfoncée lors d’un événement donné.
4.228.1. Syntaxe JavaScript
Reference_Syntax.shift = false | true;- or -Reference_Syntax.shift = 0 | 1;
4.228.2. Guide de référence FormCalc
Reference_Syntax.shift = 0 | 1
4.228.3. Valeurs
Type Valeurs
Booléen • true | 1(par défaut)
• false | 0
La touche Maj est enfoncée lors de l’exécution d’un événement.
• false | 0
La touche Maj n’est pas enfoncée lors de l’exécution d’un événement.
4.228.4. Application
Modèle Objet
Modèle Event eventPseudoModel
4.228.5. Version
XFA 2.1
Propriétés de script
4.228.6. Exemples
4.228.7. JavaScript
xfa.event.shift;
4.228.8. FormCalc
xfa.event.shift
4.229. short
Spécifie la longueur du plus petit côté de l’objet medium.
La longueur spécifiée par la propriété short doit être inférieure à celle spécifiée par la propriété long.
4.229.1. Syntaxe
Reference_Syntax.short = "0in | measurement"
4.229.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.229.3. Application
Modèle Objet
Modèle de formulaire medium
464
Propriétés de script 4
4.229.4. Version
465
XFA 2.1
4.229.5. Exemples
4.229.6. JavaScript
xfa.form.form1.pageSet.Page1.medium.short;
4.229.7. FormCalc
xfa.form.form1.pageSet.Page1.medium.short
4.230. signatureType
Indique le mode d’enregistrement d’un formulaire comportant une signature du document comme document PDF certifié.
4.230.1. Syntaxe
Reference_Syntax.signatureType = "filler | author"
4.230.2. Valeurs
Type Valeurs
Chaîne • filler(par défaut)
• author
Enregistre le formulaire comme document PDF certifié.
• author
Les documents comportant des signatures d’auteur sont considérés comme documents certifiés. Après avoir enregistré le formulaire comme au format PDF et l’avoir ouvert dans Acrobat, l’utilisateur peut cliquer sur le champ de signature pour certifier l’intégralité du document.
Propriétés de script
4.230.3. Application
Modèle Objet
Modèle de formulaire mdp
4.230.4. Version
XFA 2.5
4.231. size
Mesure indiquant la taille du contour de la case à cocher ou du bouton radio, soit la hauteur et la largeur s’il s’agit d’une case à cocher, soit le diamètre s’il s’agit d’un bouton radio.
4.231.1. Syntaxe
Reference_Syntax.size = "10pt | measurement"
4.231.2. Valeurs
Type Valeurs
Chaîne • 10pt(par défaut)
• Toute mesure valable.
• Pour l’objet font, cette propriété indique la taille de la police.
• Pour l’objet checkButton, cette propriété indique soit la hauteur ou la largeur d’une case à cocher, soit le diamètre d’un bouton radio.
Les valeurs de cette propriété varient en fonction de l’objet de référencement :
• Pour l’objet font, cette propriété indique la taille de la police.
• Pour l’objet checkButton, cette propriété indique soit la hauteur ou la largeur d’une case à cocher, soit le diamètre d’un bouton radio.
466
Propriétés de script 4
4.231.3. Application
467
Modèle Objet
Modèle de formulaire checkButtonfont
4.231.4. Version
XFA 2.1
4.231.5. Exemples
4.231.6. JavaScript
CheckBox1.resolveNode("ui.#checkButton").size = "20pt";
4.231.7. FormCalc
CheckBox1.ui.#checkButton.size = "20pt"
4.232. slope
Indique l’orientation de la ligne.
4.232.1. Syntaxe
Reference_Syntax.slope = "\ | /"
Propriétés de script
4.232.2. Valeurs
Type Valeurs
Chaîne • \(barre oblique inversée) (par défaut)
• /(barre oblique)
La ligne s’étend du coin supérieur gauche au coin inférieur droit.
• /(barre oblique)
La ligne s’étend du coin inférieur gauche au coin supérieur droit.
4.232.3. Application
Modèle Objet
Modèle de formulaire line
4.232.4. Version
XFA 2.1
4.232.5. Exemples
4.232.6. JavaScript
Line1.resolveNode("value.#line").slope = "/";
4.232.7. FormCalc
Line1.value.#line.slope = "/"
468
Propriétés de script 4
4.233. soapFaultCode
469
Indique tout code incorrect survenant lors de la tentative d’exécution par l’utilisateur d’une connexion au service Web.
4.233.1. Syntaxe
Reference_Syntax.soapFaultCode = "string"
4.233.2. Valeurs
Type Valeurs
Chaîne Chaîne valable représentant le code de défaillance SOAP.
4.233.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.233.4. Version
XFA 2.1
Propriétés de script
4.234. soapFaultString
Indique le message descriptif correspondant à un code incorrect lors de la connexion à un service Web particulier.
4.234.1. Syntaxe
Reference_Syntax.size = "10pt | measurement"
4.234.2. Valeurs
Type Valeurs
Chaîne Chaîne valable représentant le message du code de défaillance SOAP.
4.234.3. Application
Modèle Objet
Modèle Event eventPseudoModel
4.234.4. Version
XFA 2.1
4.235. somExpression
Récupère l’expression de syntaxe de référence correspondant à ce nœud.
4.235.1. Syntaxe
Reference_Syntax.somExpression
470
Propriétés de script 4
4.235.2. Valeurs
471
Type Valeurs
Chaîne Chaîne valide représentant une expression de syntaxe de référence complète.
4.235.3. Application
tree, classe classe
4.235.4. Version
XFA 2.1
4.235.5. Exemples
4.235.6. JavaScript
TextField1.somExpression;
4.235.7. FormCalc
TextField1.somExpression
4.236. spaceAbove
Indique la quantité d’espacement vertical et la taille maximale de police sur la première ligne d’un paragraphe.
4.236.1. Syntaxe
Reference_Syntax.spaceAbove = "0in | measurement"
Propriétés de script
4.236.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.236.3. Application
Modèle Objet
Modèle de formulaire para
4.236.4. Version
XFA 2.1
4.236.5. Exemples
4.236.6. JavaScript
TextField1.para.spaceAbove = "2pt";
4.236.7. FormCalc
TextField1.para.spaceAbove = "2pt"
472
Propriétés de script 4
4.237. spaceBelow
473
Indique la quantité d’espacement vertical et la taille maximale de police sur la première ligne d’un paragraphe.
4.237.1. Syntaxe
Reference_Syntax.spaceAbove = "0in | measurement"
4.237.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.237.3. Application
Modèle Objet
Modèle de formulaire para
4.237.4. Version
XFA 2.1
4.237.5. Exemples
4.237.6. JavaScript
TextField1.para.spaceBelow = "2pt";
4.237.7. FormCalc
TextField1.para.spaceBelow = "2pt"
Propriétés de script
4.238. startAngle
Indique l’angle à l’origine d’un arc.
4.238.1. Syntaxe
Reference_Syntax.startAngle = "0 | angle"
4.238.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• Valeur supérieure à 0 et inférieure ou égale à 360.
4.238.3. Application
Modèle Objet
Modèle de formulaire arc
4.238.4. Version
XFA 2.1
4.238.5. Exemples
4.238.6. JavaScript
Circle1.resolveNode("value.#arc").startAngle = "12";
4.238.7. FormCalc
Circle1.value.#arc.startAngle = "12"
474
Propriétés de script 4
4.239. startChar
475
Indique le caractère de commande de départ facultatif à ajouter au début des données du code à barres.
La propriété starChar n’est pas prise en compte par l’analyseur si le modèle du code à barres ne prend pas en charge le caractère de commande de départ spécifié.
4.239.1. Syntaxe
Reference_Syntax.startChar = "character"
4.239.2. Valeurs
Type Valeurs
Chaîne Chaîne valable représentant un caractère de commande.
4.239.3. Application
Modèle Objet
Modèle de formulaire barcode
4.239.4. Version
XFA 2.1
4.239.5. Exemples
4.239.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").startChar = "*";
4.239.7. FormCalc
Code11BarCode1.ui.#barcode.startChar = "*"
Propriétés de script
4.240. startNew
Indique s’il est nécessaire de commencer une nouvelle zone de contenu ou une page même lorsque la zone de contenu ou de page actuelle est dotée du nom requis.
Cette propriété est sans effet, à moins que la propriété before (désapprouvée) possède la valeur contentArea ou pageArea.
4.240.1. Syntaxe
Reference_Syntax.startNew = "0 | 1"
4.240.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
Ne commence pas de nouvelle zone de contenu ou de page si la zone actuelle est dotée du nom indiqué.
• 1
Commence une nouvelle zone de contenu ou page.Le nom de la zone de contenu ou de la page est fourni par la propriété beforeTarget (désapprouvée).
4.240.3. Application
Modèle Objet
Modèle de formulaire break (désapprouvé)breakAfterbreakBefore
4.240.4. Version
XFA 2.1
476
Propriétés de script 4
4.240.5. Exemples
4.240.6. JavaScript
477
Subform1.break.startNew = "1";
4.240.7. FormCalc
Subform1.break.startNew = "1"
4.241. stateless
Détermine si les variables d’un script sont conservées d’une invocation à l’autre.
4.241.1. Syntaxe
Reference_Syntax.stateless = "0 | 1"
4.241.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
Les variables du script sont conservées (si la propriété stateful est activée).
• 1
Les variables du script ne sont pas conservées (si la propriété stateless est activée).
4.241.3. Application
Modèle Objet
Modèle de formulaire script
Propriétés de script
4.241.4. Version
XFA 2.1
4.241.5. Exemples
4.241.6. JavaScript
TextField1.resolveNode("#event.#script").stateless = "1";
4.241.7. FormCalc
TextField1.#event.#script.stateless = "1"
4.242. stock
Spécifie le nom d’un format de papier standard.
4.242.1. Syntaxe
Reference_Syntax.stock = "letter | paper_size"
4.242.2. Valeurs
Type Valeurs
Chaîne • lettre(par défaut)
• Toute valeur de format de papier valide.
4.242.3. Application
Modèle Objet
Modèle de formulaire medium
478
Propriétés de script 4
4.242.4. Version
479
XFA 2.1
4.242.5. Exemples
4.242.6. JavaScript
xfa.form.form1.pageSet.Page1.medium.stock = "A4";
4.242.7. FormCalc
xfa.form.form1.pageSet.Page1.medium.stock = "A4"
4.243. stroke
Indique l’aspect d’une ligne.
4.243.1. Syntaxe
Reference_Syntax.stroke = "solid | dashed | dotted | dashDot | dashDotDot | lowered | raised | etched | embossed"
4.243.2. Valeurs
Type Valeurs
Chaîne • solid(par défaut)
• dashed
• dotted
• dashDot
• dashDotDot
• lowered
• raised
Propriétés de script
Chaîne • etched
• embossed
Chaîne Pleine.
• dashed
• dotted
• dashDot
• dashDotDot
• lowered
• raised
• etched
• embossed
Succession de tirets rectangulaires.
• dotted
• dashDot
• dashDotDot
• lowered
• raised
• etched
• embossed
Chaîne Succession de points ronds.
• dashDot
• dashDotDot
• lowered
• raised
• etched
• embossed
Type Valeurs
480
Propriétés de script 4
481
Chaîne (suite)
Alternance de tirets et de points.
• dashDotDot
• lowered
• raised
• etched
• embossed
Succession de tirets suivis de deux points.
• lowered
• raised
• etched
• embossed
Ligne encadrant une zone enfoncée.
• raised
• etched
• embossed
Ligne encadrant une zone surélevée.
• etched
• embossed
Ligne gravée sur la surface de dessin. embossedLigne en relief sur la surface de dessin.
Type Valeurs
4.243.3. Application
Modèle Objet
Modèle de formulaire corneredge
4.243.4. Version
XFA 2.1
Propriétés de script
4.243.5. Exemples
4.243.6. JavaScript
Line1.resolveNode("value.#line.edge").stroke = "etched";
4.243.7. FormCalc
Line1.value.#line.edge.stroke = "etched"
4.244. sweepAngle
Indique la longueur d’un arc, exprimée comme un angle.
4.244.1. Syntaxe
Reference_Syntax.sweepAngle = "360 |angle"
4.244.2. Valeurs
Type Valeurs
Chaîne • 360(par défaut)
• Une valeur inférieure à 360 et supérieure ou égale à 0.
4.244.3. Application
Modèle Objet
Modèle de formulaire arc
4.244.4. Version
XFA 2.1
482
Propriétés de script 4
4.244.5. Exemples
4.244.6. JavaScript
483
Circle1.resolveNode("value.#arc").sweepAngle = "45";
4.244.7. FormCalc
Circle1.value.#arc.sweepAngle = "45"
4.245. tabDefault
Spécifie la distance entre les taquets de tabulation par défaut.
Par défaut, aucun taquet de tabulation par défaut n’est défini.
4.245.1. Syntaxe
Reference_Syntax.tabDefault = "string"
4.245.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant la distance entre les taquets de tabulation par défaut.
4.245.3. Application
Modèle Objet
Modèle de formulaire para
4.245.4. Version
XFA 2.1
Propriétés de script
4.245.5. Exemples
4.245.6. JavaScript
TextField1.para.tabDefault = "3in";
4.245.7. FormCalc
TextField1.para.tabDefault = "3in"
4.246. tabStops
Spécifie une liste d’emplacements de taquets de tabulation et de propriétés de filet de conduite séparés par des espaces.
Entre la marge de gauche et le taquet de tabulation le plus à droite dans la liste, ces emplacements de taquets de tabulation remplacent les taquets de tabulation par défaut spécifiés par la propriété tabDefault. Les taquets de tabulation par défaut reprennent à droite de cette zone.
Chaque entrée de la liste de taquets de tabulation se compose d’un mot-clé qui définit l’alignement au taquet de tabulation, suivi par un espace, et par la distance comprise entre la marge de gauche et le taquet de tabulation.
Il est possible également de définir les propriétés des filets de conduite et notamment le motif et la longueur du motif.
4.246.1. Syntaxe
Reference_Syntax.tabStops = alignment leader (leaderPattern (leaderAlign leader-PatterWidth)) measurement
484
Propriétés de script 4
4.246.2. Valeurs
485
Type Valeurs
Chaîne L’alignement du taquet de tabulation est défini par l’une des valeurs suivantes :
• center
• left
• right
• decimal
Spécifie un taquet de tabulation centré.
• left
• right
• decimal
Spécifie un taquet de tabulation aligné à gauche.
• right
• decimal
Spécifie un taquet de tabulation aligné à droite.
• decimal
Spécifie un taquet de tabulation qui aligne le contenu le long de la base.
Propriétés de script
Chaîne Les propriétés du filet de conduite associé à un taquet de tabulation sont les suivantes :
• leaderPattern
• leaderAlign
• Indique le mode d’alignement du modèle de filet de conduite dans le sens de progression normal. Si la valeur est none, aucun alignement spécial n’est appliqué. Si la valeur est page, le modèle est aligné comme si son cycle débutait à partir du bord de la page.
Indique le modèle du filet de conduite utilisé pour remplir l’espace entre une tabulation et le caractère suivant. Les valeurs sont space | rule | dots | use-content.Si la valeur est définie sur rule, le filet de conduite est défini par une ligne. La propriété ruleThickness est une mesure valide permettant de préciser l’épaisseur de la ligne. ruleStyle peut posséder l’une des valeurs suivantes : solid (par défaut), dotted, dashed, none, double, groove ou ridge.Si vous choisissez la valeur dots, le filet de conduite est défini par un ensemble continu de points. Vous pouvez choisir également toute autre chaîne.
• leaderAlign
• Indique le mode d’alignement du modèle de filet de conduite dans le sens de progression normal. Si la valeur est none, aucun alignement spécial n’est appliqué. Si la valeur est page, le modèle est aligné comme si son cycle débutait à partir du bord de la page.
• leaderPatternWidth
Définit l’intervalle du cycle des modèles du filet de conduite pour dots, use-content et, dans certains cas rule.Toute mesure valide convient.Si le contenu est plus court que la valeur de cette propriété, chaque répétition du motif est complétée par un espace vierge pour correspondre à la longueur du contenu. Dans le cas contraire, la longueur du motif du filet de conduite est ignorée.
Chaîne Toute mesure valide est autorisée en guise de mesure du taquet de tabulation.
Type Valeurs
4.246.3. Application
Modèle Objet
Modèle de formulaire para
486
Propriétés de script 4
4.246.4. Version
487
XFA 2.1
4.246.5. Exemples
4.246.6. JavaScript
TextField1.para.tabStops = "left leader (rule(solid 0.5pt)) 4in”;
4.246.7. FormCalc
TextField1.para.tabStops = "left leader (rule(solid 0.5pt)) 4in”
4.247. target
Indique l’objet sur lequel l’action se produit.
4.247.1. Syntaxe
Reference_Syntax.target = "ObjectName | Reference_Syntax | URL"
4.247.2. Valeurs
Type Valeurs
Chaîne Chaîne valable représentant le nom d’un objet de modèle de formulaire, d’une expression de syntaxe de référence ou d’une URL auquel les données sont envoyées.La valeur de cette propriété doit être compatible avec la valeur de la propriété targetType. Par exemple, il serait considéré comme une erreur que la propriété targetType identifie une zone de page et que la propriété target identifie une zone de contenu, ou vice versa.
Propriétés de script
4.247.3. Application
Modèle Objet
Modèle Event eventPseudoModel
Modèle de formulaire breakAfterbreakBeforeoverflowsetPropertysignDatasubmit
4.247.4. Version
XFA 2.4
4.247.5. Exemples
4.247.6. JavaScript
xfa.event.target = "click"; - or - Subform1.breakAfter.targetType = "contentArea"; Subform1.breakAfter.target = "#ContentArea2";
4.247.7. FormCalc
xfa.event.target = "click" - or - Subform1.breakAfter.targetType = "contentArea" Subform1.breakAfter.target = "#ContentArea2"
LIENS CONNEXES :Référence aux objetsEnregistrement d’un formulaire
488
Propriétés de script 4
4.248. targetType
489
Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu avant la disposition du sous-formulaire parent.
La propriété targetType remplace la propriété désapprouvée break.before (désapprouvée).
4.248.1. Syntaxe
Reference_Syntax.targetType = "auto | contentArea | pageArea"
4.248.2. Valeurs
Type Valeurs
Chaîne La valeur de cette propriété doit être compatible avec la valeur de la propriété target. Par exemple, il serait considéré comme une erreur que la propriété target identifie une zone de page et que la propriété targetType définie sur contentArea, ou vice versa.
• auto(par défaut)
• contentArea
• pageArea
La détermination d’une transition vers une nouvelle page ou zone de contenu est déléguée à l’application de traitement. Aucune transition vers une nouvelle page ou zone de contenu n’est imposée.
• contentArea
• pageArea
Transitions de rendu vers la prochaine zone de contenu disponible.
• pageArea
Transitions de rendu vers une nouvelle page.La propriété startNew modifie également certains de ces comportements.
Propriétés de script
4.248.3. Application
Modèle Objet
Modèle de formulaire breakAfterbreakBefore
4.248.4. Version
XFA 2.4
4.248.5. Exemples
4.248.6. JavaScript
Subform1.breakAfter.targetType = "contentArea"; Subform1.breakAfter.target = "#ContentArea2";
4.248.7. FormCalc
Subform1.breakAfter.targetType = "contentArea" Subform1.breakAfter.target = "#ContentArea2"
4.249. textEncoding
Indique le codage du contenu de texte dans un document.
4.249.1. Syntaxe
Reference_Syntax.textEncoding = "UTF-8 | UTF-16 | Shift-JIS | Big-Five |ISO-8859-1 | ISO-8859-2 | ISO-8859-7 | KSC-5601 | GB-2312 | UCS-2 | fontSpecific"
490
Propriétés de script 4
4.249.2. Valeurs
491
La valeur de cette propriété est sensible à la casse et doit correspondre à l’une des valeurs suivantes.
REMARQUE : Utilisez les valeurs ISO-8859-1, ISO-8859-2 et ISO-8859-7 uniquement lorsque vous savez qu’Adobe Acrobat ne sera pas utilisé pour envoyer les données de formulaire.
TypeChaîne
Valeurs
• none(par défaut)
• ISO-8859-1
• ISO-8859-2
• ISO-8859-7
• Shift-JIS
• KSC-5601
• Big-Five
• GB-2312
• UTF-8
• UTF-16
• UCS-2
• fontSpecific
Aucun codage spécifique n’est indiqué. Les caractères sont codés à l’aide du codage disponible sur le système d’exploitation.
• ISO-8859-1
• ISO-8859-2
• ISO-8859-7
• Shift-JIS
• KSC-5601
• Big-Five
• GB-2312
• UTF-8
• UTF-16
Propriétés de script
• UCS-2
• fontSpecific
Les caractères sont codés selon la norme ISO-8859-1, également connue sous l’appellation Latin-1.
• ISO-8859-2
• ISO-8859-7
• Shift-JIS
• KSC-5601
• Big-Five
• GB-2312
• UTF-8
• UTF-16
• UCS-2
• fontSpecific
Les caractères sont codés selon la norme ISO-8859-2.
• ISO-8859-7
• Shift-JIS
• KSC-5601
• Big-Five
• GB-2312
• UTF-8
• UTF-16
• UCS-2
• fontSpecific
Les caractères sont codés selon la norme ISO-8859-7.
• Shift-JIS
• KSC-5601
• Big-Five
• GB-2312
• UTF-8
492
Propriétés de script 4
493
• UTF-16
• UCS-2
• fontSpecific
Les caractères sont codés selon la norme JIS X 0208, plus connue sous le nom de Shift-JIS.
• KSC-5601
• Big-Five
• GB-2312
• UTF-8
• UTF-16
• UCS-2
• fontSpecific
Les caractères sont codés selon le code CII (Code for Information Interchange, Hangul et Hanja).
• Big-Five
• GB-2312
• UTF-8
• UTF-16
• UCS-2
• fontSpecific
Les caractères sont codés en chinois traditionnel (Big-5). Il n’existe pas de norme officielle relative au codage Big-5. Aussi, plusieurs variantes sont disponibles. Le modèle d’objet de formulaire d’Adobe utilise la variante mise en œuvre par Microsoft® sous la forme de code.
• GB-2312
• UTF-8
• UTF-16
• UCS-2
• fontSpecific
Les caractères sont codés en chinois simplifié.
• UTF-8
• UTF-16
Propriétés de script
• UCS-2
• fontSpecific
Les caractères sont codés à l’aide de points de code Unicode selon les normes Unicode et de la numérotation consécutive UTF-8 (selon la norme ISO/IEC 10646).
• UTF-16
• UCS-2
• fontSpecific
Les caractères sont codés à l’aide de points de code Unicode selon les normes Unicode et de la numérotation consécutive UTF-16 (selon la norme ISO/IEC 10646).
• UCS-2
• fontSpecific
Les caractères sont codés à l’aide de points de code Unicode (selon les normes Unicode) et de la numérotation consécutive UCS-2 (selon la norme ISO/IEC 10646).
• fontSpecific
Les caractères sont codés d’après la police. Chaque caractère est représenté par un octet de 8 bits.
4.249.3. Application
Modèle Objet
Modèle de formulaire submit
4.249.4. Version
XFA 2.1
4.249.5. Exemples
4.249.6. JavaScript
Button1.event.submit.textEncoding = "UCS-2";
494
Propriétés de script 4
4.249.7. FormCalc
495
Button1.event.submit.textEncoding = "UCS-2"
4.250. textEntry
Détermine si un utilisateur peut saisir une valeur dans une liste déroulante.
4.250.1. Syntaxe
Reference_Syntax.textEntry = "0 | 1"
4.250.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
Empêche l’utilisateur de saisir une valeur dans le champ actif. Il doit obligatoirement effectuer sa sélection dans la liste déroulante.
• 1
Permet à l’utilisateur de saisir ou de sélectionner une valeur dans la liste déroulante. L’utilisateur dispose ainsi d’un champ dont les valeurs admises ne sont pas restrictives. Si la propriété open est définie sur multiSelect, l’utilisateur n’est pas autorisé à saisir des valeurs dans le champ.
4.250.3. Application
Modèle Objet
Modèle de formulaire choiceList
4.250.4. Version
XFA 2.1
Propriétés de script
4.250.5. Exemples
4.250.6. JavaScript
DropDownList1.resolveNode("ui.#choiceList").textEntry = "1";
4.250.7. FormCalc
DropDownList1.ui.#choiceList.textEntry = "1"
4.251. textIndent
Indique la position horizontale de la première ligne par rapport au reste d’un paragraphe.
Une valeur négative indique un retrait à gauche alors qu’une valeur positive indique la mise en retrait de la première ligne.
4.251.1. Syntaxe
Reference_Syntax.textIndent = "0in | measurement"
4.251.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.251.3. Application
Modèle Objet
Modèle de formulaire para
496
Propriétés de script 4
4.251.4. Version
497
XFA 2.1
4.251.5. Exemples
4.251.6. JavaScript
TextField1.para.textIndent = "3in";
4.251.7. FormCalc
TextField1.para.textIndent = "3in"
4.252. textLocation
Indique l’emplacement de tout texte associé au code à barres.
La zone disponible pour le texte incorporé, le cas échéant, est définie par le format du code à barres. Pour la plupart des formats de codes à barres, il s’agit d’une zone unique contiguë. Cependant, dans le cas des codes à barres EAN, cette zone est divisée en quatre plus petites qui héritent des propriétés typeface et size du champ englobant. La conception de formulaire doit indiquer les propriétés typeface et size pour le champ qui s’adaptera à l’espace fourni sans chevaucher de barres. La propriété typeface doit être non proportionnelle.
4.252.1. Syntaxe
Reference_Syntax.textLocation = "below | none | above | aboveEmbedded | belowEm-bedded"
Propriétés de script
4.252.2. Valeurs
Type Valeurs
Chaîne • below(par défaut)
• above
• belowEmbedded
• aboveEmbedded
• none
Place le texte en dessous du code à barres.
• above
• belowEmbedded
• aboveEmbedded
• none
Place le texte au-dessus du code à barres.
• belowEmbedded
• aboveEmbedded
• none
Incorpore partiellement le texte à la partie inférieure du code à barres en l’alignant sur le bas des barres.
• aboveEmbedded
• none
Incorpore partiellement le texte à la partie supérieure du code à barres en l’alignant avec le haut des barres.
• none
N’affiche pas de texte.
4.252.3. Application
Modèle Objet
Modèle de formulaire barcode
498
Propriétés de script 4
4.252.4. Version
499
XFA 2.1
4.252.5. Exemples
4.252.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").textLocation = "aboveEmbedded";
4.252.7. FormCalc
Code11BarCode1.ui.#barcode.textLocation = "aboveEmbedded"
4.253. thickness
Indique l’épaisseur ou le poids de la ligne.
4.253.1. Syntaxe
Reference_Syntax.thickness = "0.5pt | measurement"
4.253.2. Valeurs
Type Valeurs
Chaîne • 0.5pt(par défaut)
• Toute mesure valable.
Propriétés de script
4.253.3. Application
Modèle Objet
Modèle de formulaire corneredge
4.253.4. Version
XFA 2.1
4.253.5. Exemples
4.253.6. JavaScript
TextField1.border.edge.thickness = "0.2in";
4.253.7. FormCalc
TextField1.border.edge.thickness = "0.2in"
4.254. this
Récupère le nœud actif, qui est le nœud de départ lors de l’utilisation des méthodes resolveNode et resolveNodes.
REMARQUE : cette propriété est en lecture seule.
4.254.1. Syntaxe
this
500
Propriétés de script 4
4.254.2. Valeurs
501
Type Valeurs
Objet L’objet actif.
4.254.3. Application
Modèle Objet
Modèle XFA xfa
4.254.4. Version
XFA 2.1
4.254.5. Exemples
4.254.6. JavaScript
this
4.254.7. FormCalc
this
LIENS CONNEXES :Référence aux objetsUtilisation de la numérotation des pages et du nombre de pagesModification de la couleur d’arrière-plan
Propriétés de script
4.255. timeout
Spécifie le nombre de secondes autorisé pour la tentative d’exécution de la requête.
4.255.1. Syntaxe
Reference_Syntax.timeout = "string"
4.255.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le nombre de secondes avant l’expiration de la requête.
4.255.3. Application
Modèle Objet
Modèle sourceSet commandconnect
4.255.4. Version
XFA 2.1
4.255.5. Exemples
Dans ces exemples, Titles désigne le nom de la connexion aux données.
4.255.6. JavaScript
xfa.sourceSet.Titles.connect.timeout = "10";
4.255.7. FormCalc
xfa.sourceSet.Titles.connect.timeout = "10"
502
Propriétés de script 4
4.256. timeStamp
503
Indique le tampon de date et d’heure pour ce nœud.
4.256.1. Syntaxe
Reference_Syntax.timeStamp = "string"
4.256.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant une date et une heure.
4.256.3. Application
Modèle Objet
Modèle XFA xfa
4.256.4. Version
XFA 2.1
Propriétés de script
4.257. title
Définit et obtient le titre du document. Cette méthode est uniquement disponible pour les applications client.
4.257.1. Syntaxe
Reference_Syntax.titre
4.257.2. Valeurs
Type Valeurs
Chaîne Chaîne valable représentant le titre du formulaire actif.
4.257.3. Application
Modèle Objet
Modèle Host hostPseudoModel
4.257.4. Version
XFA 2.1
4.257.5. Exemples
4.257.6. JavaScript
xfa.host.title;
4.257.7. FormCalc
xfa.host.title
504
Propriétés de script 4
4.258. topInset
505
Mesure représentant la taille d’une insertion en haut.
4.258.1. Syntaxe
Reference_Syntax.topInset = "0in | measurement"
4.258.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.258.3. Application
Modèle Objet
Modèle de formulaire margin
4.258.4. Version
XFA 2.1
4.258.5. Exemples
4.258.6. JavaScript
Subform1.margin.topInset "1in";
4.258.7. FormCalc
Subform1.margin.topInset "1in"
Propriétés de script
4.259. trailer
Indique l’objet sous-formulaire ou subformSet devant être placé en bas d’une zone de contenu ou d’une zone de page.
La propriété trailer remplace les propriétés overflowTrailer (désapprouvée) et bookendTrailer (désapprouvée).
4.259.1. Syntaxe
Reference_Syntax.trailer = "string"
4.259.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant l’ID ou l’expression de syntaxe de référence complète d’un sous-formulaire ou d’un jeu de sous-formulaires. La valeur par défaut est une chaîne vide.
4.259.3. Application
Modèle Objet
Modèle de formulaire bookendbreakAfterbreakBeforeoverflow
4.259.4. Version
XFA 2.4
4.259.5. Exemples
4.259.6. JavaScript
Subform1.breakBefore.trailer = "Subform2";
506
Propriétés de script 4
4.259.7. FormCalc
507
Subform1.breakBefore.trailer = "Subform2"
4.260. transferEncoding
Indique le codage du contenu binaire dans le document référencé.
4.260.1. Syntaxe
Reference_Syntax.transferEncoding = "none | base64"
4.260.2. Valeurs
Type Valeurs
Chaîne • none(par défaut)
• base64
Le document référencé n’est pas codé. Si le document référencé est spécifié via une URI, il sera transféré sous forme de flux d’octets. Si le document référencé est intégré, il doit se conformer aux restrictions relatives au type de données PCDATA.
• base64
Le contenu binaire est codé conformément aux normes de codage des transferts base64.
4.260.3. Application
Modèle Objet
Modèle de formulaire exDataimage
Modèle sourceSet bind
Propriétés de script
4.260.4. Version
XFA 2.1
4.261. transient
Spécifie si l’application de traitement doit sauvegarder la valeur du groupe d’exclusion lors de l’envoi du formulaire ou d’une opération de sauvegarde.
4.261.1. Syntaxe
Reference_Syntax.transient = "0 | 1"
4.261.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
La valeur du groupe d’exclusion doit être sauvegardée.
• 1
Le groupe d’exclusion ne doit pas être sauvegardé.
4.261.3. Application
Modèle Objet
Modèle de formulaire exclGroup
4.261.4. Version
XFA 2.1
508
Propriétés de script 4
4.262. truncate
509
Tronque le bord droit du code à barres pour les formats pris en charge.
La troncature s’applique seulement au code à barres PDF417. L’analyseur ignore cette propriété pour les formats de codes à barres auxquels elle ne s’applique pas.
4.262.1. Syntaxe
Reference_Syntax.truncate = "0 | 1"
4.262.2. Valeurs
Type Valeurs
Chaîne • 0(par défaut)
• 1
Inclut la marque de synchronisation du système droitier.
• 1
Omet la marque de synchronisation du système droitier.
4.262.3. Application
Modèle Objet
Modèle de formulaire barcode
4.262.4. Version
XFA 2.1
Propriétés de script
4.262.5. Exemples
4.262.6. JavaScript
Code11BarCode1.resolveNode("ui.#barcode").truncate = "1";
4.262.7. FormCalc
Code11BarCode1.ui.#barcode.truncate = "1"
4.263. type
Spécifie le modèle utilisé par un objet.
Pour l’objet radial, la propriété type indique le sens du flux d’un dégradé de couleurs.
Pour l’objet subjectDNs, la propriété type indique si les valeurs fournies dans l’élément doivent être traitées comme étant restrictives ou non restrictives.
4.263.1. Syntaxe
Reference_Syntax.type = "toRight | toLeft | toTop | toBottom"
4.263.2. Valeurs
Type Valeurs
Chaîne Les valeurs de cette propriété varient en fonction de l’objet de référencement.
Pour l’objet barcode:Chaîne identifiant le modèle de code à barres. Cette propriété doit être fournie. L’ensemble de valeurs prises en charge pour cette propriété dépend du périphérique d’affichage.Cette propriété signale plusieurs types de codes à barres, comme indiqué par les valeurs ci-dessous :
• codabar
• Codabar, comme défini dans ANSI/AIM BC3-1995, USS Codabar.
• code2Of5Industrial
• Code 2 parmi 5 (industriel) ; pas de norme officielle.
510
Propriétés de script 4
511
• code2Of5Interleaved
• Code 2 parmi 5 (entrelacé), comme défini dans ANSI/AIM BC2-1995, USS Interleaved 2-of-5.
• code2Of5Matrix
• Code 2 parmi 5 (matriciel) ; pas de norme officielle.
• code2Of5Standard
• Code 2 parmi 5 ; pas de norme officielle.
• code3Of9
• Code 39 (appelé également code 3 parmi 9), comme défini dans ANSI/AIM BC1-1995, USS Code 39.
• code3Of9extended
• Code 39 étendu ; pas de norme officielle.
• code11
• Code 11 (USD-8) ; pas de norme officielle.
• code49
• Code 49, comme défini dans ANSI/AIM BC6-1995, USS Code 49.
• code93
• Code 93, comme défini dans ANSI/AIM BC5-1995, USS Code 93.
• code128
• Code 128, comme défini dans ANSI/AIM BC4-1995, Code 128.
• code128A
• Code 128 A, comme défini dans ANSI/AIM BC4-1995, ISS Code 128.
• code128B
• Code 128 B, comme défini dans ANSI/AIM BC4-1995, ISS Code 128.
• code128C
• Code 128 C, comme défini dans ANSI/AIM BC4-1995, ISS Code 128.
• code128SSCC
• Code 128 (serial shipping container code), comme défini dans ANSI/AIM BC4-1995, ISS Code 128.
Type Valeurs
Propriétés de script
• ean8
• EAN-8, comme défini dans ISO/EEC 15420.
• ean8add2
• EAN-8 avec addendum de 2 chiffres, comme défini dans ISO/EEC 15420.
• ean8add5
• EAN-8 avec addendum de 5 chiffres, comme défini dans ISO/EEC 15420.
• ean13
• EAN-13, comme défini dans ISO/EEC 15420.
• ean13pwcd
• EAN-13 avec données client prix/poids.
• ean13add2
• EAN-13 avec addendum de 2 chiffres.
• ean13add5
• EAN-13 avec addendum de 5 chiffres.
• fim
• Marque d’identification United States Postal Service, comme définie dans First-Class Mail (USPS-C100).
• logmars
• Applications logistiques d’Automated Marking and Reading Symbols (logmars), comme définies par United States Military Standard MIL-STD-1189B .
• maxicode
• UPS Maxicode, comme défini dans ANSI/AIM BC10-ISS Maxicode.
• msi
• Modified Plessey (MSI). Pouvait être appelé autrement autrefois, mais ce n’est plus le cas.
• pdf417
• PDF417, comme défini dans USS PDF417.
Type Valeurs
512
Propriétés de script 4
513
• pdf417macro
• PDF417, mais permet également aux données de se répandre sur plusieurs codes à barres PDF417. Les codes à barres sont marqués de façon à ce que le lecteur du code à barres sache s’il a toujours des codes à barres supplémentaires à lire et peut le signaler à l’opérateur le cas échéant.
• plessey
• Plessey ; pas de norme officielle.
• postAUSCust2
• Australian Postal Customer 2 (format standard de la poste australienne), comme défini dans Customer Barcoding Technical Specifications (Spécifications techniques des codes à barres clients).
• postAUSCust3
• Australian Postal Customer 3 (format standard de la poste australienne), comme défini dans Customer Barcoding Technical Specifications (Spécifications techniques des codes à barres clients).
• postAUSReplyPaid
• Australian Postal Standard (format standard de la poste australienne), comme défini dans Customer Barcoding Technical Specifications (Spécifications techniques des codes à barres clients).
• postAUSStandard
• Australian Postal Standard (format standard de la poste australienne), comme défini dans Customer Barcoding Technical Specifications (Spécifications techniques des codes à barres clients).
• postUKRM4SCC
• United Kingdom RM4SCC (Royal Mail 4-State Customer Code), comme défini dans le guide How to Use Mailsort Guide (guide d’instructions sur le tri du courrier).
• postUSDPBC
• Code à barres United States Postal Service Delivery Point, comme défini dans le DMM C840 Barcoding Standards for Letters and Flats.
• postUSStandard
• Code à barres United States Postal Service POSTNET (code postal à 4 chiffres), comme défini dans le DMM C840 Barcoding Standards for Letters and Flats.
Type Valeurs
Propriétés de script
• postUSZip
• Code à barres United States Postal Service POSTNET (code postal américain à 5 chiffres), comme défini dans le DMM C840 Barcoding Standards for Letters and Flats.
• qr
• QR Code, comme défini dans ISS - QR Code.
• telepen
• Telepen, comme défini dans USS Telepen.
• ucc128
• UCC/EAN 128, comme défini dans International Symbology Specification (Spécifications internationales de la symbologie) - Code 128 (1999).
• ucc128random
• UCC/EAN 128 Random Weight, comme défini dans International Symbology Specification (Spécifications internationales de la symbologie) - Code 128 (1999).
• ucc128sscc
• UCC/EAN 128 (serial shipping container code - SSCC), comme défini dans International Symbology Specification (Spécifications internationales de la symbologie) - Code 128 (1999).
• upcA
• UPC-A, comme défini dans ISO/EEC 15420.
• upcAadd2
• UPC-A avec addendum de 2 chiffres, comme défini dans ISO/EEC 15420.
• upcAadd5
• UPC-A avec addendum de 5 chiffres, comme défini dans ISO/EEC 15420.
• upcApwcd
• UPC-A avec données client prix/poids, comme défini dans ISO/EEC 15420.
• upcE
• UPC-E, comme défini dans ISO/EEC 15420.
• upcEadd2
• UPC-E avec addendum de 2 chiffres, comme défini dans ISO/EEC 15420.
Type Valeurs
514
Propriétés de script 4
515
• upcEadd5
• UPC-E avec addendum de 5 chiffres, comme défini dans ISO/EEC 15420.
• upcean2
• UPC/EAN avec addendum de 2 chiffres, comme défini dans ISO/EEC 15420.
• upcean5
• UPC/EAN avec addendum de 5 chiffres, comme défini dans ISO/EEC 15420.
Pour l’objet digestMethods, encodings, subjectDNs et timeStamp:Indique si les options de signature sont restreintes aux options de filtrage.
• facultatif(par défaut)
• required
Les options de signature ne sont pas restreintes aux options de filtrage. Les valeurs fournies dans l’élément sont des valeurs de base facultatives pouvant être utilisées par l’application de traitement XFA. L’application de traitement XFA peut également fournir sa propre valeur.
• required
Les options de signature sont restreintes aux options de filtrage. Les valeurs fournies dans l’élément sont des valeurs de base pouvant être utilisées par l’application de traitement XFA.
Type Valeurs
Propriétés de script
Pour l’objet linear:Indique le sens du flux d’un dégradé de couleurs.
• toRight(par défaut)
• toLeft
• toTop
• toBottom
La couleur de départ s’affiche à l’extrémité gauche de l’objet et évolue vers la couleur d’arrivée située à l’extrémité droite.
• toLeft
• toTop
• toBottom
La couleur de départ s’affiche à l’extrémité droite de l’objet et évolue vers la couleur d’arrivée située à l’extrémité gauche.
• toTop
• toBottom
La couleur de départ s’affiche à l’extrémité inférieure de l’objet et évolue vers la couleur d’arrivée située à l’extrémité supérieure.
• toBottom
La couleur de départ s’affiche à l’extrémité supérieure de l’objet et évolue vers la couleur d’arrivée à l’extrémité inférieure.
Pour l’objet radial:Indique la direction d’un dégradé de couleurs.
• toEdge(par défaut)
• toCenter
La couleur de départ s’affiche au centre de l’objet et évolue vers la couleur d’arrivée située à l’extérieur.
• toCenter
La couleur de départ s’affiche à l’extérieur de l’objet et évolue vers la couleur d’arrivée située au centre.
Type Valeurs
516
Propriétés de script 4
4.263.3. Application
517
Modèle Objet
Modèle de formulaire barcodehandlerissuerslinearoids
patternradialreasonssigningsubjectDNstimeStamp
Modèle sourceSet extras
4.263.4. Version
XFA 2.1
4.264. typeface
Indique le nom d’une police de caractères.
4.264.1. Syntaxe
Reference_Syntax.typeface = "Courier | typeface"
4.264.2. Valeurs
Type Valeurs
Chaîne • Courier(par défaut)
• Tout identificateur de police valable.
Propriétés de script
4.264.3. Application
Modèle Objet
Modèle de formulaire font
4.264.4. Version
XFA 2.1
4.264.5. Exemples
4.264.6. JavaScript
TextField1.font.typeface = "Myriad Pro";
4.264.7. FormCalc
TextField1.font.typeface = "Myriad Pro"
4.265. underline
Indique l’activation et le type de soulignement.
4.265.1. Syntaxe
Reference_Syntax.underline = "0 | 1 | 2"
518
Propriétés de script 4
4.265.2. Valeurs
519
Type Valeurs
Chaîne • 0(par défaut)
• La police est générée sans soulignement.
• 1
• La police est générée avec un soulignement simple.
• 2
• La police est générée avec soulignement double.
4.265.3. Application
Modèle Objet
Modèle de formulaire font
4.265.4. Version
XFA 2.1
4.265.5. Exemples
4.265.6. JavaScript
TextField1.font.underline = "2";
4.265.7. FormCalc
TextField1.font.underline = "2"
Propriétés de script
4.266. underlinePeriod
Contrôle l’aspect du soulignement.
4.266.1. Syntaxe
Reference_Syntax.underlinePeriod = "all | word"
4.266.2. Valeurs
Type Valeurs
Chaîne • all(par défaut)
• La ligne rendue doit s’étendre aux sauts de mots.
• word
• La ligne rendue doit être interrompue aux sauts de mots.
4.266.3. Application
Modèle Objet
Modèle de formulaire font
4.266.4. Version
XFA 2.1
4.266.5. Exemples
4.266.6. JavaScript
TextField1.font.underlinePeriod = "word";
520
Propriétés de script 4
4.266.7. FormCalc
521
TextField1.font.underlinePeriod = "word"
4.267. upsMode
Représente le mode dans un code à barres UPS Maxicode.
4.267.1. Syntaxe
Reference_Syntax.upsMode = “usCarrier | internationalCarrier | standardSymbol | secureSymbol”
4.267.2. Valeurs
Type Valeurs
Chaîne • usCarrier(par défaut)
• Transporteur aux Etats-Unis avec des codes postaux contenant jusqu’à neuf chiffres.
• internationalCarrier
• Transporteur international avec codes postaux alphanumériques contenant jusqu’à six chiffres.
• standardSymbol
• Informations codées de non livraison jusqu’à 90 caractères.
• secureSymbol
• Informations codées de non livraison jusqu’à 74 caractères (plus de quatre corrections).
Propriétés de script
4.267.3. Application
Modèle Objet
Modèle de formulaire barcode
4.267.4. Version
XFA 2.5
4.268. url
Spécifie l’URL pour cet objet.
4.268.1. Syntaxe
Reference_Syntax.url = "string"
4.268.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant une URL pour ce nœud individuel.
4.268.3. Application
Modèle Objet
Modèle de formulaire certificates
4.268.4. Version
XFA 2.5
522
Propriétés de script 4
4.269. urlPolicy
523
Spécifie le type d’URL représenté par l’objet de certificat.
Il équivaut à l’attribut urlType des documents PDF, et ses valeurs sont codées comme Navigateur, ASSP ou la chaîne saisie par l’utilisateur pour la clé urlType.
4.269.1. Syntaxe
Reference_Syntax.urlPolicy = "enrollmentServer | roamingCredentialServer | string"
4.269.2. Valeurs
Type Valeurs
Chaîne • enrollmentServer
• L’URL référence un serveur Web auquel l’utilisateur peut s’adresser pour demander un certificat numérique.
• roamingCredentialServer
• L’URL référence un service Web qui contient les informations d’identification numériques qu’un utilisateur utilise pour signer un document ou des données.
• Chaîne valide qui prolonge l’utilisation de cette propriété avec des valeurs uniques.
4.269.3. Application
Modèle Objet
Modèle de formulaire certificates
4.269.4. Version
XFA 2.5
Propriétés de script
4.270. usage
Spécifie les contextes d’utilisation de la connexion.
4.270.1. Syntaxe
Reference_Syntax.usage = "exportAndImport | exportOnly | importOnly"
4.270.2. Valeurs
Type Valeurs
Chaîne • exportAndImport(par défaut)
• Utilisée pour l’importation et l’exportation.
• exportOnly
• Utilisée pendant l’exportation, ignorée pendant l’importation.
• importOnly
• Utilisée pendant l’importation, ignorée pendant l’exportation.
4.270.3. Application
Modèle Objet
Modèle de formulaire connect
4.270.4. Version
XFA 2.1
524
Propriétés de script 4
4.270.5. Exemples
4.270.6. JavaScript
525
TextField1.connect.usage = "importOnly";
4.270.7. FormCalc
TextField1.connect.usage = "importOnly"
4.271. use
Appelle un prototype.
4.271.1. Syntaxe
Reference_Syntax.use = "string"
4.271.2. Valeurs
Type Valeurs
Chaîne La valeur de cette propriété est un caractère ‘#’ suivi par l’identificateur du prototype.
4.271.3. Application
Modèle Objet
Modèle connectionSet effectiveInputPolicyeffectiveOutputPolicyoperationrootElementsoapActionsoapAddressuriwsdlAddress
Propriétés de script
Modèle de formulaire arcareaassistbarcodebookendbooleanborderbreak (désapprouvé)breakAfterbreakBeforebuttoncalculatecaptioncertificatecertificatescheckButtonchoiceListcolorcomb
Modèle sourceSet booleancommandconnectconnectString
Modèle Objet
4.271.4. Version
XFA 2.1
4.272. usehref
Appelle un prototype externe.
REMARQUE : La propriété usehref ne peut pas cibler de fichiers PDF, même si ceux-ci contiennent des objets de modèle d’objet de formulaire XML.
Si un objet contient à la fois les propriétés use et usehref, la propriété usehref a la priorité sur la propriété use. Ce niveau de priorité permet l’utilisation d’un prototype différent lors de la génération du rendu des conceptions de formulaire sur des systèmes existants. Les systèmes existants ne tiendront pas compte de la propriété usehref.
Pour contrôler les questions de sécurité, indiquez HTTPS pour l’URI usehref ou assurez-vous que toutes les références de prototypes surviennent derrière un pare-feu.
526
Propriétés de script 4
4.272.1. Syntaxe
527
Reference_Syntax.usehref = "string"
4.272.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant un prototype externe. La valeur de cette propriété inclut un caractère ‘#’ et l’identificateur du prototype :
usehref="URL#XML_ID" usehref="URL#ref(reference_syntax)"
4.272.3. Application
Modèle Objet
Modèle connectionSet effectiveInputPolicyeffectiveOutputPolicyoperationrootElementsoapActionsoapAddressuriwsdlAddress
Modèle de formulaire arcareaassistbarcodebookendbooleanborderbreak (désapprouvé)breakAfterbreakBeforebuttoncalculatecaptioncertificatecertificatescheckButtonchoiceListcolorcomb
Propriétés de script
Modèle sourceSet bindbooleancommandconnect
Modèle Objet
4.272.4. Version
XFA 2.4
4.273. uuid
Indique l’identificateur unique universel (UUID) pour cet objet.
4.273.1. Syntaxe
Reference_Syntax.uuid = "string"
4.273.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant un identificateur unique universel pour ce nœud individuel.
4.273.3. Application
Modèle Objet
Modèle XFA xfa
4.273.4. Version
XFA 2.1
528
Propriétés de script 4
4.274. validationMessage
529
Indique la chaîne de message de validation pour ce champ.
4.274.1. Syntaxe
Reference_Syntax.validationMessage = "string"
4.274.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant un message de validation à l’attention de l’utilisateur.
4.274.3. Application
Modèle Objet
Modèle de formulaire exclGroupfield
4.274.4. Version
XFA 2.1
4.274.5. Exemples
4.274.6. JavaScript
NumericField1.validationMessage = "This is the validation message."
4.274.7. FormCalc
NumericField1.validationMessage = "This is the validation message."
Propriétés de script
4.275. validationsEnabled
Indique si les scripts de validation seront exécutés ou non.
4.275.1. Syntaxe JavaScript
Reference_Syntax.validationsEnabled = false | true; - or - Reference_Syntax.validationsEnabled = 0 | 1;
4.275.2. Syntaxe FormCalc
Reference_Syntax.validationsEnabled = 0 | 1
4.275.3. Valeurs
Type Valeurs
Booléen • false | 0(par défaut)
• Les scripts de validation sont désactivés.
• true | 1
• Les scripts de validation sont activés.
4.275.4. Application
Modèle Objet
Modèle Host hostPseudoModel
4.275.5. Version
XFA 2.1
530
Propriétés de script 4
4.275.6. Exemples
4.275.7. JavaScript
531
xfa.host.validationsEnabled = 1;
4.275.8. FormCalc
xfa.host.validationsEnabled = 1
4.276. vAlign
Indique l’alignement de texte vertical.
4.276.1. Syntaxe
Reference_Syntax.vAlign = "top | middle | bottom"
4.276.2. Valeurs
Type Valeurs
Chaîne • top(par défaut)
• Aligne le texte sur le bord supérieur de la zone disponible.
• middle
• Centre le texte verticalement sur la zone disponible.
• bottom
• Aligne le texte sur le bord inférieur de la zone disponible.
Propriétés de script
4.276.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldparasous-formulaire
4.276.4. Version
XFA 2.1
4.276.5. Exemples
4.276.6. JavaScript
TextField1.vAlign = "top";
4.276.7. FormCalc
TextField1.vAlign = "top"
4.277. value
Indique la valeur de l’objet actuel.
Indique une liste de valeurs séparées par des virgules pour chacune des composantes de l’espace colorimétrique.
4.277.1. Syntaxe
Reference_Syntax.value = "various"
532
Propriétés de script 4
4.277.2. Valeurs
533
Type Valeurs
Variable Les valeurs diffèrent selon l’objet de référencement.Par exemple, la propriété value d’un objet field est une chaîne représentant la valeur réelle affichée dans le champ ou la valeur liée du champ.Pour les objets nécessitant une valeur de couleur, cette propriété spécifie une liste de valeurs séparée par des virgules pour chacun des composants de l’espace colorimétrique. Pour l’espace colorimétrique SRVB, les valeurs des composantes doivent suivre le format r,v,b, où r est la valeur de la composante rouge, v celle de la composante verte et b celle de la composante bleue. Chaque valeur doit être comprise entre 0 et 255 (inclus). La valeur 255 représente l’intensité d’affichage maximale. Par exemple, 255,0,0 correspond à la couleur rouge.La couleur par défaut varie selon le contexte dans lequel une couleur est utilisée. Elle est déterminée par l’objet qui englobe l’objet de couleur.
4.277.3. Application
S’applique également aux objets provenant de la classe textNode class.
Modèle Objet
Modèle de données dataValue
Modèle de formulaire booleancouleurdatedateTimedecimalfloatimageintegerpicturescripttexttime
Modèle sourceSet booleanintegertext
4.277.4. Version
XFA 2.1
Propriétés de script
4.277.5. Exemples
4.277.6. JavaScript
// Utiliser la propriété value pour définir et obtenir la valeur de la variable de document. TextField1.rawValue = docVar.value;
4.277.7. FormCalc
// Utiliser la propriété value pour définir et obtenir la valeur de la variable de document. TextField1 = docVar.value
LIENS CONNEXES :Création d’un nœud dans le modèle de donnéesManipulation des instances d’un sous-formulaireObtention ou définition des valeurs d’objetConcaténation de valeurs de données Modification de la couleur d’arrière-planRemplissage d’une liste déroulante
4.278. valueRef
Résout une valeur de données pour chaque nœud de données dans le jeu identifié par l’objet ref.
Les valeurs de données sont ensuite utilisées pour remplir les éléments de valeur, tels que <items save='1'>.
La propriété valueRef est une expression de syntaxe de référence relative.
REMARQUE : cette propriété est en lecture seule.
4.278.1. Syntaxe
Reference_Syntax.valueRef = "string"
534
Propriétés de script 4
4.278.2. Valeurs
535
Type Valeurs
Chaîne Chaîne valide représentant une valeur de données pour chaque nœud du jeu.
4.278.3. Application
Modèle Objet
Modèle de formulaire bindItems
4.278.4. Version
XFA 2.4
4.279. variation
Indique le conditionnement de l’application exécutant le script.
Cette méthode est uniquement disponible pour les applications client.
REMARQUE : cette propriété est en lecture seule.
4.279.1. Syntaxe
Reference_Syntax.variation
4.279.2. Valeurs
Type Valeurs
Chaîne Chaîne valide représentant le conditionnement de l’application. Par exemple, dans le cas d’un formulaire PDF ouvert dans Acrobat, cette propriété renvoie l’une des valeurs suivantes : Reader, Fill-in, Business Tools ou Full.
Propriétés de script
4.279.3. Application
Modèle Objet
Modèle Host hostPseudoModel
4.279.4. Version
XFA 2.1
4.279.5. Exemples
4.279.6. JavaScript
xfa.host.variation;
4.279.7. FormCalc
xfa.host.variation
4.280. version
Indique le numéro de version de l’application active.
REMARQUE : cette propriété est en lecture seule.
4.280.1. Syntaxe
Reference_Syntax.version
536
Propriétés de script 4
4.280.2. Valeurs
537
Type Valeurs
Chaîne Chaîne valide représentant le conditionnement de l’application. Par exemple, dans Acrobat 6.0.1, cette propriété renvoie 6.0.1.
4.280.3. Application
Modèle Objet
Modèle de formulaire handler
Modèle Host hostPseudoModel
4.280.4. Version
XFA 2.1
4.280.5. Exemples
4.280.6. JavaScript
xfa.host.version;
4.280.7. FormCalc
xfa.host.version
Propriétés de script
4.281. vScrollPolicy
Indique si un champ peut défiler verticalement.
REMARQUE : cette propriété ne s’applique pas aux champs de texte pouvant être ajustés pour contenir des données ou du texte.
4.281.1. Syntaxe
Reference_Syntax.vScrollPolicy = "auto | on | off"
4.281.2. Valeurs
Type Valeurs
Chaîne • auto(par défaut)
• Les champs ne contenant qu’une seule ligne défilent horizontalement et les champs à plusieurs lignes défilent verticalement (une barre de défilement verticale s’affiche si besoin est).
• on
• Les barres de défilement verticales s’affichent, même si le texte ou les données dépassent la limite de débordement du champ.
• off
• Empêche l’utilisateur de saisir des caractères lorsque la capacité physique du champ est atteinte (délimitée par la largeur de champ). Notez que cette restriction ne s’applique pas aux données de champ.
4.281.3. Application
Modèle Objet
Modèle de formulaire textEdit
4.281.4. Version
XFA 2.5
538
Propriétés de script 4
4.281.5. Exemples
4.281.6. JavaScript
539
TextField1.resolveNode("ui.#textEdit").vScrollPolicy = "off";
4.281.7. FormCalc
TextField1.ui.#textEdit.vScrollPolicy = "off"
4.282. w
Mesure indiquant la largeur pour la disposition.
Lorsque vous spécifiez la largeur, la valeur remplace la plage d’accroissement définie par les propriétés minW et maxW. Si cette propriété est omise ou configurée comme chaîne vide, ce sont les propriétés minW et maxW qui définissent la largeur de l’objet.
4.282.1. Syntaxe
Reference_Syntax.w = "0in | measurement"
4.282.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
Propriétés de script
4.282.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldsous-formulaire
4.282.4. Version
XFA 2.1
4.282.5. Exemples
4.282.6. JavaScript
TextField1.w = "3in";
4.282.7. FormCalc
TextField1.w = "3in"
4.283. weight
Définit l’épaisseur d’une police de caractères.
4.283.1. Syntaxe
Reference_Syntax.weight = "bold | normal"
540
Propriétés de script 4
4.283.2. Valeurs
541
Type Valeurs
Chaîne • gras(par défaut)
• La police est générée en gras.
• normal
• La police est générée selon l’épaisseur par défaut.
4.283.3. Application
Modèle Objet
Modèle de formulaire font
4.283.4. Version
XFA 2.1
4.283.5. Exemples
4.283.6. JavaScript
TextField1.font.weight = "normal";
4.283.7. FormCalc
TextField1.font.weight = "normal"
Propriétés de script
4.284. wideNarrowRatio
Spécifie un rapport barre large/barre étroite dans les codes à barres pris en charge.
L’éventail de rapports autorisé varie selon les formats de codes à barres. Pour les codes à barres matériel, c’est le périphérique de sortie qui diffère. Le modèle ne doit pas spécifier de valeur dépassant la plage autorisée. L’analyseur ignore cette propriété pour les formats de codes à barres qui n’autorisent pas de rapport variable entre les différentes largeurs de barres.
4.284.1. Syntaxe
Reference_Syntax.wideNarrowRatio = "3:1 | wide[:narrow]"
4.284.2. Valeurs
Type Valeurs
Chaîne • 3:1(par défaut)
• wide[:narrow]
Tout rapport valide utilisant la syntaxe suivante :
• wide[:narrow]
où wide est un nombre positif représentant le numérateur du rapport, et narrow est un nombre positif facultatif représentant le dénominateur du rapport.Si la valeur narrow n’est pas fournie, elle est définie par défaut sur 1.
4.284.3. Application
Modèle Objet
Modèle de formulaire barcode
4.284.4. Version
XFA 2.1
542
Propriétés de script 4
4.284.5. Exemples
4.284.6. JavaScript
543
Barcode1.resolveNode("ui.#barcode").wideNarrowRatio = "5:1";
4.284.7. FormCalc
Barcode1.ui.#barcode.wideNarrowRatio = "5:1"
4.285. wordCharacterCount
Définit le nombre minimum de groupes de graphèmes nécessaires pour appliquer la césure à un mot. Les mots n’ayant pas suffisamment de groupes de graphèmes ne peuvent pas faire l’objet d’une césure.
4.285.1. Syntaxe
Reference_Syntax.wordCharacterCount = "integer"
4.285.2. Valeurs
Type Valeurs
Entier Entier valide représentant le nombre de groupes de graphèmes. La valeur par défaut est 7.
4.285.3. Application
Modèle Objet
Modèle de formulaire hyphenation
4.285.4. Version
XFA 2.8
Propriétés de script
4.286. wordSpacingMaximum
Définit l’espace intermots maximum (en pourcentage) lorsque le texte est justifié et/ou si la césure est activée.
Si l’espace maximum spécifié ou par défaut est inférieur à l’espacement des mots optimal, il est ignoré et la valeur optimale est appliquée à la place.
4.286.1. Syntaxe
Reference_Syntax.wordSpacingMaximum = "[0..100]%"
4.286.2. Valeurs
Type Valeurs
Chaîne Valeur en pourcentage comprise entre 0 et 100. La valeur par défaut est 100%.
4.286.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldparasous-formulaire
4.286.4. Version
XFA 2.8
4.286.5. Exemples
4.286.6. JavaScript
TextField1.para.wordSpacingMaximum = "40%";
544
Propriétés de script 4
4.286.7. FormCalc
545
TextField1.para.wordSpacingMaximum = "40%"
4.287. wordSpacingMinimum
Définit l’espace intermots minimum (en pourcentage) lorsque le texte est justifié et/ou si la césure est activée.
Si l’espace minimum spécifié ou par défaut est supérieur à l’espacement des mots optimal, il est ignoré et la valeur optimale est appliquée à la place.
4.287.1. Syntaxe
Reference_Syntax.wordSpacingMinimum = "[0..100]%"
4.287.2. Valeurs
Type Valeurs
Chaîne Valeur en pourcentage comprise entre 0 et 100. La valeur par défaut est 100%.
4.287.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldparasous-formulaire
4.287.4. Version
XFA 2.8
Propriétés de script
4.287.5. Exemples
4.287.6. JavaScript
TextField1.para.wordSpacingMinimum = "40%";
4.287.7. FormCalc
TextField1.para.wordSpacingMinimum = "40%"
4.288. wordSpacingOptimum
Définit l’espace intermots optimal (en pourcentage) lorsque le texte est justifié et/ou si la césure est activée.
4.288.1. Syntaxe
Reference_Syntax.wordSpacingOptimum = "[0..100]%"
4.288.2. Valeurs
Type Valeurs
Chaîne Valeur en pourcentage comprise entre 0 et 100. La valeur par défaut est 100%.
4.288.3. Application
Modèle Objet
Modèle de formulaire drawexclGroupfieldparasous-formulaire
546
Propriétés de script 4
4.288.4. Version
547
XFA 2.8
4.288.5. Exemples
4.288.6. JavaScript
TextField1.para.wordSpacingOptimum = "80%";
4.288.7. FormCalc
TextField1.para.wordSpacingOptimum = "80%"
4.289. x
Indique la coordonnée X du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Les conteneurs dont le contenu est distribué n’utilisent pas les coordonnées x.
4.289.1. Syntaxe
Reference_Syntax.x = "0in | measurement"
4.289.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
Propriétés de script
4.289.3. Application
Modèle Objet
Modèle de formulaire areacontentAreadrawexclGroupfieldsous-formulaire
4.289.4. Version
XFA 2.1
4.289.5. Exemples
4.289.6. JavaScript
TextField1.x = "5in";
4.289.7. FormCalc
TextField.x = "5in"
4.290. xdpContent
Définit le sous-ensemble de données qui est envoyé. Cette propriété est utilisée uniquement lorsque la propriété format est xdp.
4.290.1. Syntaxe
Reference_Syntax.xdpContent = "string"
548
Propriétés de script 4
4.290.2. Valeurs
549
Type Valeurs
Chaîne • datasets pdf xfdf(par défaut)
• Envoie les objets comprenant les sous-ensembles de balises, pdf et xfdf à l’hôte.
• tag1 tag2 ... tagN
• Envoie les objets contenant des balises correspondant à l’une des balises spécifiées.
• * (astérisque)
• Envoie tous les objets de données à l’hôte.
4.290.3. Application
Modèle Objet
Modèle de formulaire submit
4.290.4. Version
XFA 2.1
4.290.5. Exemples
4.290.6. JavaScript
Button1.resolveNode("#event.#submit").xdpContent = "*"
4.290.7. FormCalc
Button1.#event.#submit.xdpContent = "*"
Propriétés de script
4.291. y
Indique la coordonnée Y du point d’ancrage d’un conteneur par rapport au coin supérieur gauche du conteneur parent lors d’un placement avec disposition positionnée.
Les conteneurs dont le contenu est distribué n’utilisent pas les coordonnées y.
4.291.1. Syntaxe
Reference_Syntax.y = "0in | measurement"
4.291.2. Valeurs
Type Valeurs
Chaîne • 0in(par défaut)
• Toute mesure valable.
4.291.3. Application
Modèle Objet
Modèle de formulaire areacontentAreadrawexclGroupfieldsous-formulaire
4.291.4. Version
XFA 2.1
550
Propriétés de script 4
4.291.5. Exemples
4.291.6. JavaScript
551
TextField1.y = "5in";
4.291.7. FormCalc
TextField.y = "5in"
Méthodes de script
5. Méthodes de script
Ces méthodes sont compatibles avec cet environnement de programmation.
Chaque hôte (par exemple, Acrobat, Adobe Reader ou Designer)®est chargé de mettre en œuvre les méthodes disponibles. Certaines méthodes, comme la méthode beep, ne présentent aucun intérêt sur un serveur. Le serveur n’implémente pas ces méthodes et peut même produire un message d’erreur si l’utilisateur essaie d’appeler la méthode.
5.1. Méthodes de script pour Acrobat et Adobe Reader
5.1.1. absPage
Détermine la page du formulaire sur laquelle s’affiche pour la première fois un objet de conception de formulaire donné.
Syntaxe
Reference_Syntax.absPage( OBJECT param )
Paramètres
param L’expression de syntaxe de référence complète d’un des objets de conception de formulaire suivants : field, draw, subform, area, pageArea, contentArea.
Renvoie
Entier représentant la page du formulaire (base 0).
REMARQUE : il n’est pas possible de trouver les champs figurant dans un sous-formulaire masqué. Dans ce cas, la méthode ne permet pas de renvoyer le numéro de page. En revanche, si le sous-formulaire est visible, mais que les champs sont masqués, la méthode indique le numéro de page sur laquelle ces champs résident.
552
Méthodes de script 5
Application
553
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
TextField2.rawValue = xfa.layout.absPage(this);
FormCalc
TextField2 = xfa.layout.absPage($)
LIENS CONNEXES :Utilisation de la numérotation des pages et du nombre de pages
5.1.2. absPageCount
Détermine la quantité de pages du formulaire actuel.
Syntaxe
Reference_Syntax.absPageCount()
Paramètres
Aucun
Renvoie
Entier représentant le nombre de pages dans le formulaire actuel.
Méthodes de script
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
TextField2.rawValue = xfa.layout.absPageCount();
FormCalc
TextField2 = xfa.layout.absPageCount()
LIENS CONNEXES :Utilisation de la numérotation des pages et du nombre de pages
5.1.3. absPageCountInBatch
Détermine la quantité de pages du lot actuel.
Syntaxe
Reference_Syntax.absPageCountInBatch()
Version
2.5
Paramètres
Aucun
554
Méthodes de script 5
Renvoie
555
Entier représentant la quantité de pages du lot actuel.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
5.1.4. absPageInBatch
Détermine la page du lot qui contient l’objet de formulaire.
Syntaxe
Reference_Syntax.absPageInBatch( OBJECT param )
Version
2.5
Paramètres
param L’expression de syntaxe de référence complète d’un des objets de formulaire suivants : field, draw, subform, area, pageArea, contentArea.
Renvoie
Entier représentant le nombre de pages contenant l’objet de formulaire.
Méthodes de script
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.5
5.1.5. absPageSpan
Détermine le nombre de pages utilisé par un objet de formulaire donné.
Syntaxe
Reference_Syntax.absPageSpan( OBJECT param )
Paramètres
param L’expression de syntaxe de référence complète d’un des objets de formulaire suivants : field, draw, subform, area, pageArea, contentArea.
Renvoie
Entier représentant le nombre de pages qu’occupe l’objet de formulaire spécifié.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
556
Méthodes de script 5
Exemples
JavaScript
557
xfa.layout.absPageSpan(Subform1);
FormCalc
xfa.layout.absPageSpan(Subform1)
5.1.6. addInstance
Ajoute une instance d’un sous-formulaire ou d’un jeu de sous-formulaires au modèle de formulaire.
Syntaxe
Reference_Syntax.addInstance( BOOLEAN param )
Paramètres
param (Facultatif)
Indique si le nouveau sous-formulaire ou jeu de sous-formulaires dispose d’une valeur de données correspondante dans le modèle de données.
• true | 1(JavaScript) ou 1(FormCalc)(default)
• Fusion du nouveau sous-formulaire ou d’un jeu de sous-formulaire avec le modèle de données.
• false | 0(JavaScript) ou 0(FormCalc)
• Ne pas effectuer d’opération de fusion.
Renvoie
Nouvel objet de formulaire, ou valeur nulle si aucun objet n’a été ajouté.
Méthodes de script
Application
Modèle Objet
Modèle de formulaire instanceManager
Version
XFA 2.1
Exemples
JavaScript
Subform1.instanceManager.addInstance(1);
FormCalc
Subform1.instanceManager.addInstance(1)
LIENS CONNEXES :Manipulation des instances d’un sous-formulaire
5.1.7. addItem
Ajoute de nouveaux éléments au champ de formulaire actuel. Par exemple, cette méthode permet d’ajouter des éléments à une liste déroulante.
Syntaxe
Reference_Syntax.addItem( STRING param1 [, CHAINE param2 ] )
Paramètres
param1 Chaîne valide représentant la valeur à afficher dans le champ.
param2 (Facultatif)
Chaîne valide représentant la valeur liée du nouvel élément. Lorsqu’elle est vide, la valeur par défaut correspond à une chaîne vide.
558
Méthodes de script 5
Renvoie
559
Vide
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.1
Exemples
JavaScript
DropDownList1.addItem("Human Resources");
FormCalc
DropDownList1.addItem("Human Resources")
LIENS CONNEXES :Remplissage d’une liste déroulante
5.1.8. addNew
Ajoute un nouvel enregistrement au jeu d’enregistrements.
Syntaxe
Reference_Syntax.addNew()
Paramètres
Aucun
Méthodes de script
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Exemples
JavaScript
xfa.sourceSet.dataConnectionName.addNew();
FormCalc
xfa.sourceSet.dataConnectionName.addNew();
5.1.9. append
Ajoute un nœud à la fin de la liste de nœuds.
Syntaxe
Reference_Syntax.append( OBJECT param )
Paramètres
param Expression de syntaxe de référence valide représentant le nœud à ajouter.
560
Méthodes de script 5
Renvoie
561
Vide
Application
list, classe
Version
XFA 2.1
Exemples
JavaScript
// Ajouter un nœud de groupe de données à un autre nœud de modèle de données. xfa.record.nodes.append(oGroupNode);
FormCalc
// Ajouter un nœud de groupe de données à un autre nœud de modèle de données. xfa.record.nodes.append(oGroupNode)
LIENS CONNEXES :Création d’un nœud dans le modèle de données
5.1.10. applyXSL
Applique une transformation XSL à une représentation XML du nœud actif. Cela revient à appeler saveXML et à transformer le résultat à l’aide du document XSL spécifié.
Syntaxe
Reference_Syntax.applyXSL( STRING param )
Paramètres
param Chaîne valide représentant les données de transformation XSL à appliquer.
Méthodes de script
Renvoie
Chaîne valide représentant le résultat de la transformation XSL.
Application
node, classe classe
Version
XFA 2.1
5.1.11. assignNode
Evalue l’expression de syntaxe de référence dans le contexte actif et définit la valeur du nœud détecté. Si le nœud n’existe pas, il peut être créé.
Syntaxe
Reference_Syntax.assignNode( STRING param1 [, CHAINE param2 [, INTEGER param3 ] ] )
Paramètres
param1 Chaîne valide représentant une expression de syntaxe de référence pointant vers un nœud particulier.
param2 (Facultatif)
Chaîne valide représentant la valeur à attribuer au nœud.
562
Méthodes de script 5
563
param3 (Facultatif)
Valeur entière représentant l’action à effectuer à la création de nœuds. Les valeurs suivantes désignent les valeurs admises :
• 0
• Si le nœud existe, la valeur est mise à jour. Si le nœud n’existe pas, il est créé.
• 1
• Si le nœud existe, une erreur est émise. Si le nœud n’existe pas, il est créé.
• 2
• Si le nœud existe, aucune action n’est réalisée. Si le nœud n’existe pas, il est créé.
• 3
• Un nouveau nœud est toujours généré.
Renvoie
Objet correspondant au nœud spécifié.
Application
node, classe classe
Version
XFA 2.1
5.1.12. beep
Entraîne l’émission d’un son par le système. Cette méthode est uniquement disponible pour les applications client.
Syntaxe
Reference_Syntax.beep( [ INTEGER param ] )
Méthodes de script
Paramètres
param(Facultatif)
Correspond au code système du son approprié. Chaque code système correspond à un événement de programme Windows spécifique.• 0(Erreur) - Correspond à l’événement de programme Arrêt critique.
• 1(Avertissement) - Correspond à l’événement de programme Exclamation.
• 2(Question) - Correspond à l’événement de programme Question.
• 3(Etat) - Correspond à l’événement de programme Astérisque.
• 4(Par défaut) - Correspond à l’événement de programme Son par défaut.
Pour afficher la liste des événements de programmes Windows, choisissez Démarrer > Paramètres > Panneau de configuration > Sons et périphériques audio, puis cliquez sur l’onglet Sons. La liste Evénements affiche une liste des différents événements système. L’icône de haut-parleur indique qu’un son est associé à l’événement correspondant.
Renvoie
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.host.beep("3");
564
Méthodes de script 5
FormCalc
565
xfa.host.beep("3")
5.1.13. boundItem
Récupère la valeur liée d’un élément d’affichage spécifique dans une liste déroulante ou une zone de liste.
Syntaxe
Reference_Syntax.boundItem( STRING param )
Paramètres
param Chaîne valide représentant la valeur d’affichage figurant dans la zone de liste ou la liste déroulante.
Renvoie
Chaîne valide représentant la valeur liée d’une valeur d’affichage spécifiée.
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.1
Exemples
JavaScript
DropDownList1.boundItem("Text");
Méthodes de script
FormCalc
DropDownList1.boundItem("Text")
5.1.14. cancel
Annule toute modification apportée à la ligne active ou à une nouvelle ligne de l’objet de jeu d’enregistrements ou à la collection de champs d’un objet d’enregistrement, avant d’appeler la méthode update.
Syntaxe
Reference_Syntax.cancel()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Exemples
JavaScript
xfa.sourceSet.dataConnectionName.cancel();
566
Méthodes de script 5
FormCalc
567
xfa.sourceSet.dataConnectionName.cancel()
5.1.15. cancelBatch
Annule une mise à jour par lots en attente
Syntaxe
Reference_Syntax.cancelBatch()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
5.1.16. clear
Supprime une signature donnée.
Syntaxe
Reference_Syntax.clear( OBJECT param1 [, BOOLEEN param2 ] )
Méthodes de script
Paramètres
param1 input Nœud de signature XML valable.
param2 (Facultatif)
entrée (facultatif)
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Affiche une boîte de dialogue de confirmation indiquant que le champ de signature est effacé.
• false | 0(JavaScript) ou 0(FormCalc)
• N’affiche pas de boîte de dialogue de confirmation indiquant que le champ de signature est effacé.
Renvoie
True si la signature a été supprimée correctement. False dans le cas contraire. Une exception si le nœud spécifié dans param1 n’est pas un nœud de signature.
Application
Modèle Objet
Modèle de signature signaturePseudoModel
Version
XFA 2.1
Exemples
JavaScript
// Cet exemple supprime la signature de tous les objets signés sur un formulaire. var oSigs = xfa.signature.enumerate(); var iNum = oSigs.length; for (var i=0; i < iNum; i++) { var oChild = oSigs.item(i); xfa.signature.clear(child); }
568
Méthodes de script 5
FormCalc
569
// Cet exemple supprime la signature de tous les objets signés sur un formulaire. var oSigs = xfa.signature.enumerate() var iNum = oSigs.length - 1 for i=0 upto iNum step 1 do var oChild = oSigs.item(i) xfa.signature.clear(child) endfor
5.1.17. clearErrorList
Supprime tous les éléments du journal d’erreurs actuel.
Syntaxe
Reference_Syntax.clearErrorList()
Paramètres
Aucun
Renvoie
Vide
Application
model, classe classe
Version
XFA 2.1
5.1.18. clearItems
Supprime tous les éléments du champ. Cette méthode supprime par exemple tous les éléments contenus dans une zone de liste ou une liste déroulante.
Syntaxe
Reference_Syntax.clearItems()
Méthodes de script
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.1
Exemples
JavaScript
DropDownList1.clearItems();
FormCalc
DropDownList1.clearItems()
LIENS CONNEXES :Remplissage d’une liste déroulante
5.1.19. clone
Effectue la copie d’un objet.
Syntaxe
Reference_Syntax.clone( BOOLEAN param )
570
Méthodes de script 5
Paramètres
571
param Valeur booléenne indiquant si le clonage se produit de manière récursive.
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Cloner l’objet de manière récursive.
• false | 0(JavaScript) ou 0(FormCalc)
• Ne pas cloner l’objet de manière récursive
Renvoie
Copie de l’objet.
Application
node, classe classe
Version
XFA 2.1
Exemples
JavaScript
xfa.record.NewGroupNode.clone(1);
FormCalc
xfa.record.NewGroupNode.clone(1)
LIENS CONNEXES :Création d’un nœud dans le modèle de données
Méthodes de script
5.1.20. close
Ferme une connexion à une source de données.
Syntaxe
Reference_Syntax.close()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Exemples
JavaScript
xfa.sourceSet.nodes.item(nIndex).close();
FormCalc
xfa.sourceSet.nodes.item(nIndex).close()
572
Méthodes de script 5
5.1.21. createNode
573
Crée un nouveau nœud à partir d’un nom de classe correct.
REMARQUE : Vous ne pouvez pas utiliser la méthode createNode pour créer l’un des objets de modèle d’objet de formulaire XML suivants :
Syntaxe
Reference_Syntax.createNode( STRING param1 [, CHAINE param2 [, CHAINE param3 ] ] )
Paramètres
param1 Chaîne valide représentant le nom de classe de l’objet à créer.
param2 (Facultatif)
Chaîne valide représentant le nom à attribuer au nœud. S’il est vide, la valeur de ce paramètre correspond par défaut à une chaîne vide.
param3 (Facultatif)
Chaîne valide représentant l’espace de noms XML dans lequel le nœud créé existe. S’il est vide, la valeur de ce paramètre correspond par défaut à une chaîne vide.
Renvoie
Un objet représentant un nœud valide.
Application
model, classe classe.
Version
XFA 2.1
Exemples
JavaScript
// Créer un nœud de type dataGroup. var oGroupNode = xfa.datasets.createNode("dataGroup", "NewGroupNode");
Méthodes de script
FormCalc
// Créer un nœud de type dataGroup. var oGroupNode = xfa.datasets.createNode("dataGroup", "NewGroupNode")
LIENS CONNEXES :Création d’un nœud dans le modèle de données
5.1.22. currentDateTime
(currentDateTime)Renvoie la date et l’heure actuelles au format ISO 8601 (AAAAMMJJTH-HMMSS).
Syntaxe
Reference_Syntax.currentDateTime()
Paramètres
Aucun
Renvoie
La date et l’heure actuelles au format ISO 8601 (AAAAMMJJTHHMMSS).
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.8
574
Méthodes de script 5
5.1.23. delete (FormCalc uniquement)
575
Supprime l’enregistrement actif du jeu d’enregistrements.
Syntaxe
Reference_Syntax.delete()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Exemple
FormCalc
xfa.sourceSet.dataConnectionName.delete()
5.1.24. deleteItem
Supprime l’élément spécifié.
Syntaxe
Reference_Syntax.deleteItem( INTEGER param )
Méthodes de script
Paramètres
param Entier valide représentant l’index de base zéro dans l’élément.
Renvoie
True si l’élément a été supprimé, false dans le cas contraire.
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.5
JavaScript
ListBox1.deleteItem(ListBox1.selectedIndex);
FormCalc
ListBox1.deleteItem(ListBox1.selectedIndex)
5.1.25. deleteRecord
Supprime l’enregistrement actif du jeu d’enregistrements.
Syntaxe
Reference_Syntax.deleteRecord( )
Paramètres
576
Aucun
Méthodes de script 5
Renvoie
577
Vide.
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.5
JavaScript
xfa.sourceSet.dataConnectionName.deleteRecord();
FormCalc
xfa.sourceSet.dataConnectionName.deleteRecord()
5.1.26. documentCountInBatch
Détermine le nombre de documents dans le lot actuel.
Syntaxe
Reference_Syntax.documentCountInBatch()
Version
2.5
Paramètres
Aucun
Méthodes de script
Renvoie
Entier représentant le nombre total de documents du lot. Hôtes ne prenant pas en charge le renvoi du traitement par lot 1.
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.5
5.1.27. documentInBatch
Détermine le numéro du document actuel au sein du lot.
Syntaxe
Reference_Syntax.documentInBatch()
Version
2.5
Paramètres
Aucun
Renvoie
Entier représentant un numéro de document physique (de base zéro). Hôtes ne prenant pas en charge le renvoi du traitement par lot 0.
578
Méthodes de script 5
Application
579
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.5
5.1.28. emit
Indique au gestionnaire d’événement de formulaire qu’un événement est survenu.
Syntaxe
Reference_Syntax.emit()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle Event eventPseudoModel
Version
XFA 2.1
Méthodes de script
Exemples
JavaScript
xfa.event.emit();
FormCalc
xfa.event.emit()
5.1.29. enumerate
Enumère toutes les signatures XML trouvées dans le document.
Syntaxe
Reference_Syntax.enumerate()
Paramètres
Aucun
Renvoie
Un objet représentant une liste de nœuds XFA de tous les nœuds de signature XML.
Application
Modèle Objet
Modèle de signature signaturePseudoModel
Version
XFA 2.1
580
Méthodes de script 5
Exemples
JavaScript
581
//Cet exemple supprime la signature de tous les objets signés sur un formulaire. //Dans ce cas, enumerate() est utilisé pour déterminer la liste des objets signés //par la signature. var oSigs = xfa.signature.enumerate(); var iNum = oSigs.length; for (var i=0; i < iNum; i++) { var oChild = oSigs.item(i); xfa.signature.clear(child); }
FormCalc
//Cet exemple supprime la signature de tous les objets signés sur un formulaire. //Dans ce cas, enumerate() est utilisé pour déterminer la liste des objets signés //par la signature. var oSigs = xfa.signature.enumerate() var iNum = oSigs.length - 1 for i=0 upto iNum step 1 do var oChild = oSigs.item(i) xfa.signature.clear(child) endfor
5.1.30. evaluate
Récupère la liste des objets inclus dans l’élément Manifest.
Syntaxe
Reference_Syntax.evaluate()
Paramètres
Aucun
Renvoie
Un objet représentant la liste des objets.
Méthodes de script
Application
Modèle Objet
Modèle de formulaire manifest
Version
XFA 2.1
5.1.31. execCalculate
Exécute tous les scripts sur l’événement calculate de l’objet spécifié, ainsi que tous les objets enfants.
Veillez à ne pas exécuter par inadvertance cette méthode avec une plage plus grande que nécessaire. Selon la nature de vos scripts, l’événement calculate peut se déclencher plusieurs fois en réaction à une seule exécution de la méthode et déclencher l’événement calculate d’autres objets si la valeur de ces objets varie suite à l’exécution d’un script quelconque.
Syntaxe
Reference_Syntax.execCalculate()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire exclGroupfieldformulairemanifestsous-formulaire
582
Méthodes de script 5
Version
583
XFA 2.1
Exemples
JavaScript
xfa.form.execCalculate();
Exécute les scripts contenus dans l’événement calculate pour tous les objets du formulaire.
Subform1.execCalculate();
Exécute les scripts contenus dans l’événement Calculate de l’objet nommé Subform1, ainsi que tout objet contenu dans le sous-formulaire.
TextField1.execCalculate();
Exécute les scripts contenus dans l’événement Calculate de l’objet nommé TextField1.
FormCalc
xfa.form.execCalculate()
Exécute les scripts contenus dans l’événement calculate pour tous les objets du formulaire.
Subform1.execCalculate()
Exécute les scripts contenus dans l’événement Calculate de l’objet nommé Subform1, ainsi que tout objet contenu dans le sous-formulaire.
TextField1.execCalculate()
Exécute les scripts contenus dans l’événement Calculate de l’objet nommé TextField1.
5.1.32. execEvent
Exécute le script d’événement de l’objet.
Syntaxe
Reference_Syntax.execEvent( STRING param )
Méthodes de script
Paramètres
param Chaîne valide représentant le nom de l’événement à exécuter.
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire exclGroupfieldsous-formulaire
Version
XFA 2.1
Exemples
JavaScript
Button1.execEvent("click");
FormCalc
Button1.execEvent("click")
5.1.33. execInitialize
Exécute tous les scripts sur l’événement initialize de l’objet spécifié, ainsi que tous les objets enfants.
Syntaxe
Reference_Syntax.execInitialize()
584
Méthodes de script 5
Paramètres
585
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire exclGroupfieldformulairemanifestsous-formulaire
Version
XFA 2.1
Exemples
JavaScript
xfa.form.execInitialize();
Exécute les scripts contenus dans l’événement initialize pour tous les objets du formulaire.
Subform1.execInitialize();
Exécute les scripts contenus dans l’événement Initialize de l’objet nommé Subform1, ainsi que tout objet contenu dans le sous-formulaire.
TextField1.execInitialize();
Exécute les scripts contenus dans l’événement Initialize de l’objet nommé TextField1.
Méthodes de script
FormCalc
xfa.form.execInitialize()
Exécute les scripts contenus dans l’événement initialize pour tous les objets du formulaire.
Subform1.execInitialize()
Exécute les scripts contenus dans l’événement Initialize de l’objet nommé Subform1, ainsi que tout objet contenu dans le sous-formulaire.
TextField1.execInitialize()
Exécute les scripts contenus dans l’événement Initialize de l’objet nommé TextField1.
5.1.34. execute
Exécute une connexion.
Syntaxe
Reference_Syntax.execute( BOOLEAN param )
Paramètres
param • true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Force la nouvelle fusion de la conception d’un formulaire et des données WSDL importées.
• false | 0(JavaScript) ou 0(FormCalc)
• Importe les données WSDL dans le formulaire actif sans les fusionner avec la conception de formulaire.
Renvoie
True si la connexion a été établie, false dans le cas contraire.
586
Méthodes de script 5
Application
587
Modèle Objet
Modèle connectionSet wsdlConnection
Version
XFA 2.1
5.1.35. execValidate
Exécute tous les scripts sur l’événement validate de l’objet spécifié, ainsi que tous les objets enfants.
Syntaxe
Reference_Syntax.execValidate()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire fieldformulairemanifestsous-formulaire
Version
XFA 2.1
Méthodes de script
Exemples
JavaScript
xfa.form.execValidate();
Exécute les scripts contenus dans l’événement validate pour tous les objets du formulaire.
Subform1.execValidate();
Exécute les scripts contenus dans l’événement Validate de l’objet nommé Subform1, ainsi que tout objet contenu dans le sous-formulaire.
TextField1.execValidate();
Exécute les scripts contenus dans l’événement Validate de l’objet nommé TextField1.
FormCalc
xfa.form.execValidate()
Exécute les scripts contenus dans l’événement validate pour tous les objets du formulaire.
Subform1.execValidate()
Exécute les scripts contenus dans l’événement Validate de l’objet nommé Subform1, ainsi que tout objet contenu dans le sous-formulaire.
TextField1.execValidate()
Exécute les scripts contenus dans l’événement Validate de l’objet nommé TextField1.
5.1.36. exportData
Exporte dans un fichier les données contenues dans le formulaire actif au format XDP ou XML.
Pour des raisons de sécurité, si vous fournissez le premier paramètre, la méthode exportData s’exécute uniquement sur des documents certifiés. Si vous n’indiquez pas le premier paramètre, il n’est pas nécessaire de certifier le document et l’utilisateur est invité à indiquer un emplacement et un nom de fichier.
Syntaxe
Reference_Syntax.exportData( [ STRING param1 [, BOOLEEN param2 ] ])
588
Méthodes de script 5
Paramètres
589
param1(Facultatif)
Indique l’emplacement et le nom du fichier vers lequel les données seront exportées. Si vous omettez ce paramètre, une boîte de dialogue invite l’utilisateur à sélectionner le fichier manuellement.Ce paramètre s’applique uniquement à des documents certifiés pour lesquels l’utilisateur dispose des autorisations adéquates.
param2 (Facultatif)
Indique le format d’exportation des données.
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Exporter au XDP Format.
• false | 0(JavaScript) ou 0(FormCalc)
• Exporter des données XML brutes.
Pour changer de type d’exportation sans préciser de nom de fichier, vous devez fournir une chaîne vide comme premier paramètre. Par exemple :xfa.host.exportData("",0); //JavaScript xfa.host.exportData("", 0) //FormCalc
Renvoie
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.host.exportData("filename.xdp");
Méthodes de script
FormCalc
xfa.host.exportData("filename.xdp")
LIENS CONNEXES :Enregistrement d’un formulaire
5.1.37. first
Accède au premier enregistrement dans le jeu d’enregistrements et remplit le modèle de données avec les données d’enregistrement.
REMARQUE : La méthode de connexion aux données xfa.sourceSet.DataConnection.first effectue une recherche dans un tableau et le met à jour en cas de modification des données. Elle utilise la méthode hasDataChanged afin de déterminer si les données ont changé.
Syntaxe
Reference_Syntax.first()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
590
Méthodes de script 5
Exemples
JavaScript
591
xfa.sourceSet.dataConnectionName.first();
FormCalc
xfa.sourceSet.dataConnectionName.first()
5.1.38. formNodes
Renvoie la liste de tous les objets de modèle du formulaire liés à un objet de données spécifié.
Syntaxe
Reference_Syntax.formNodes( OBJECT param )
Paramètres
param1 Expression de syntaxe de référence valide représentant un objet de modèle de données.
Renvoie
Objet représentant la liste des objets de modèle du formulaire partageant une relation avec l’objet de données spécifié.
Application
Modèle Objet
Modèle de formulaire formulaire
Version
XFA 2.1
Méthodes de script
5.1.39. getAttribute
Récupère une valeur de propriété spécifiée.
Syntaxe
Reference_Syntax.getAttribute( STRING param )
Paramètres
param Chaîne valide représentant le nom de la propriété à récupérer.
Renvoie
Chaîne valide représentant la valeur de la propriété.
Application
S’applique également à la classe node, classe.
Modèle Objet
Modèle XFA packet
Version
XFA 2.1
Exemples
JavaScript
var sBOFBackup = oDB.nodes.item(nIndex).query.recordSet.getAttribute("bofAction");
FormCalc
var sBOFBackup = oDB.nodes.item(nIndex).query.recordSet.getAttribute("bofAction")
592
Méthodes de script 5
5.1.40. getDelta
593
Permet d’obtenir un objet de script delta pour une propriété spécifique.
Syntaxe
Reference_Syntax.getDelta( STRING param )
Version
2.5
Paramètres
param Une chaîne représentant la syntaxe de référence à une propriété.
Renvoie
Un objet correct représentant un objet de script delta.
Application
container, classe
Version
XFA 2.5
5.1.41. getDeltas
Recherche de façon récursive tous les objets de script delta pour cet objet de conteneur et tous ses descendants.
REMARQUE : Selon le nombre d’objets de script deltas, cette méthode peut réduire les performances d’exécution de votre formulaire.
Syntaxe
Reference_Syntax.getDeltas( )
Méthodes de script
Version
2.5
Paramètres
Aucun
Renvoie
Un objet valide représentant un objet de script delta.
Application
container, classe
Version
XFA 2.5
5.1.42. getDisplayItem
Récupère le texte d’affichage de l’élément pour l’index d’élément spécifié.
Syntaxe
Reference_Syntax.getDisplayItem( INTEGER param )
Version
2.5
Paramètres
param1 Entier représentant l’index de base de zéro dans l’élément.
594
Méthodes de script 5
Renvoie
595
Chaîne correcte représentant le texte de l’élément ou valeur nulle si aucun élément d’affichage n’existe.
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.5
5.1.43. getElement
Renvoie un objet enfant spécifié.
REMARQUE : cette méthode renvoie uniquement les objets enfant qui ne sont pas des objets conteneur, tels que field ou sous-formulaire.
Syntaxe
Reference_Syntax.getElement( STRING param1 [, INTEGER param2 ] )
Paramètres
param1 Chaîne valide représentant le nom de l’objet à récupérer.
param2 (Facultatif)
Valeur entière représentant l’instance de l’objet à récupérer.
Renvoie
L’objet spécifié.
Méthodes de script
Application
node, classe classe
Version
XFA 2.1
Exemples
JavaScript
Subform1.getElement("border");
FormCalc
Subform1.getElement("border")
5.1.44. getFocus
Recherche et renvoie l’objet de formulaire qui est actuellement la cible d’action.
Syntaxe
Reference_Syntax.getFocus()
Paramètres
Aucun
Renvoie
Objet de formulaire qui est actuellement la cible d’action ou valeur nulle si aucun objet de formulaire n’est la cible d’action.
Application
Modèle Objet
Modèle Host hostPseudoModel
596
Méthodes de script 5
Version
597
XFA 2.6
5.1.45. getInvalidObjects
Renvoie une liste de nœuds contenus dans ce sous-formulaire (inclus) qui ont échoué au test de validation.
Génère une liste de tous les objets conteneur non valides, tels que champ, groupe d’exclusion ou sous-formulaire, contenus dans des descendants de ce sous-formulaire. Si le sous-formulaire sur lequel cette méthode de script est appelée est lui-même non valide, ce sous-formulaire est inclus dans la liste renvoyée. La liste n’est générée que sur demande en parcourant de manière récursive le sous-formulaire. La liste renvoyée est dans le document.
La méthode getInvalidObjects ne renvoie la liste des champs obligatoires qu’après le déclen-chement de l’envoi. Si la liste des champs obligatoires est requise, la méthode execValidate doit être appelée en premier.
Syntaxe
Reference_Syntax.getInvalidObjects()
Paramètres
Aucun
Renvoie
Liste d’objets de conteneur non valides dans l’ordre dans lequel ils existent sur le formulaire.
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.9
Méthodes de script
5.1.46. getItemState
Renvoie l’état de sélection de l’élément spécifié.
Syntaxe
Reference_Syntax.getItemState( INTEGER param )
Version
2.5
Paramètres
param Entier valide représentant l’index de base zéro dans l’élément.
Renvoie
True si l’élément a été sélectionné, false dans le cas contraire.
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.5
5.1.47. getSaveItem
Récupère la valeur de données pour l’index d’élément spécifié.
Syntaxe
Reference_Syntax.getSaveItem( INTEGER param )
598
Méthodes de script 5
Paramètres
599
param Entier valide représentant l’index de base zéro dans l’élément.
Renvoie
Chaîne correcte représentant le texte de l’élément de données ou valeur nulle si aucun élément de données n’existe.
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.5
5.1.48. gotoRecord
Déplace l’enregistrement actif de la fenêtre de données vers un enregistrement particulier dans la plage d’enregistrements des données.
Syntaxe
Reference_Syntax.gotoRecord( INTEGER param )
Paramètres
param Valeur entière valide représentant l’enregistrement spécifié dans la plage des enregistrements.
Renvoie
Vide
Méthodes de script
Application
Modèle Objet
Modèle de données dataWindow
Version
XFA 2.1
Exemples
JavaScript
xfa.dataWindow.gotoRecord(2);
FormCalc
xfa.dataWindow.gotoRecord(2)
Pour un exemple de l’utilisation de la méthode gotorecord en vue de consulter des enregistrements de données, reportez-vous à l’exemple Browsing records stored in a data file disponible sur ww.adobe.com/go/dev_lc_scripting_samples.
5.1.49. gotoURL
Récupère l’URL spécifiée. Cette méthode est uniquement disponible pour les applications client.
Syntaxe
Reference_Syntax.gotoURL( STRING param1 )
Paramètres
param1 Chaîne valide représentant un URL complet ou relatif. Il est possible d’inclure une chaîne de requête à la fin de l’URL.Si le formulaire affiché dans un navigateur ou si Acrobat® Capture® n’est pas disponible, le module externe Weblink récupère l’URL demandée. Si le formulaire est exécuté dans Acrobat, l’URL du document actif est alors obtenue à partir de l’URL de base du document, de l’URL de la page 0 (dans le cas d’un document capturé à l’aide de WebCapture) ou à partir du système de fichiers.
600
Méthodes de script 5
Renvoie
601
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.host.gotoURL( "http://www.adobe.com");
FormCalc
xfa.host.gotoURL( "http://www.adobe.com")
5.1.50. h
Détermine la hauteur d’un objet de conception de formulaire donné.
Syntaxe
Reference_Syntax.h( OBJECT param1 [, CHAINE param2 [, INTEGER param3 ] ] )
Paramètres
param1 L’expression de syntaxe de référence complète de l’un des objets de modèle d’objet de formulaire XML suivants : area, contentArea, draw, field, pageArea, sous-formulaire.
param2 (Facultatif)
Chaîne représentant le type d’unité de la valeur renvoyée. Si le paramètre est vide, le type d’unité par défaut est points.
Méthodes de script
param3 (Facultatif)
Entier représentant une valeur d’index de base zéro indiquant la zone de contenu dans laquelle vous souhaitez obtenir la hauteur de l’objet. Si aucune valeur n’est définie, la valeur par défaut est0.Ce paramètre permet de calculer la hauteur d’un objet distribué dans plusieurs zones de contenu, telles que des pages. Par exemple, si vous souhaitez trouver la hauteur d’un objet de sous-formulaire qui s’étend sur plusieurs zones de contenu, vous pouvez utiliser ce paramètre pour calculer la hauteur du sous-formulaire dans chacune des zones de contenu et additionner les totaux.
Renvoie
Hauteur de l’objet de conception de formulaire dans la zone de contenu spécifiée.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
// Renvoie la hauteur d’une instance unique de TextField1 xfa.layout.h(TextField1,"in");
// Calcule la hauteur de Subform1 dans deux zones de contenu et affiche // le total dans un message. var iHeight = xfa.layout.h(Subform1,"in",0) + xfa.layout.h(Subform1,"in",1); xfa.host.messageBox(iHeight);
FormCalc
// Renvoie la hauteur d’une instance unique de TextField1 xfa.layout.h(TextField1,"in")
// Calcule la hauteur de Subform1 dans deux zones de contenu et affiche // le total dans un message. var iHeight = xfa.layout.h(Subform1,"in",0) + xfa.layout.h(Subform1,"in",1) xfa.host.messageBox(iHeight)
602
Méthodes de script 5
5.1.51. hasDataChanged
603
Détermine si les données de l’enregistrement actuel ont été modifiées.
Il s’agit d’une méthode de pré-validation de l’enregistrement actif. Il compare les données de l’enre-gistrement actuel avec les données d’enregistrement de la source de données active. Si les données ont changé, cette méthode renvoie la valeur true.
REMARQUE : méthodes de connexion de données xfa.sourceSet.DataConnection.first, xfa.sourceSet.DataConnection.next, xfa.sourceSet.DataConnection.previouset xfa.sourceSet.Data-Connection.last effectue une mise à jour implicite si les données ont changé.
Syntaxe
Reference_Syntax.hasDataChanged()
Paramètres
Aucun
Renvoie
True si les données ont été modifiées et false dans le cas contraire.
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Méthodes de script
5.1.52. importData
Importe les données d’un fichier spécifié dans le formulaire actif.
Pour des raisons de sécurité, si vous fournissez le paramètre, la méthode importData s’exécute uniquement sur des documents certifiés. Si vous n’indiquez pas le paramètre, il n’est pas nécessaire de certifier le document et l’utilisateur est invité à indiquer un emplacement et un nom de fichier.
Syntaxe
Reference_Syntax.importData( [ STRING param ] )
Paramètres
param(Facultatif)
Chaîne valable représentant l’emplacement et le nom du fichier à partir duquel les données seront importées. Si vous omettez ce paramètre, une boîte de dialogue invite l’utilisateur à sélectionner le fichier manuellement.Ce paramètre s’applique uniquement à des documents certifiés, pour lesquels l’utilisateur dispose des autorisations adéquates.
Renvoie
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.host.importData ("filename.xdp");
604
Méthodes de script 5
FormCalc
605
xfa.host.importData ("filename.xdp")
5.1.53. insert
Insère un nœud avant un nœud spécifique dans la liste des nœuds.
Syntaxe
Reference_Syntax.insert( OBJECT param1, OBJECT param2 )
Paramètres
param1 Expression de syntaxe de référence valide représentant le nœud à insérer.
param2 Expression de syntaxe de référence valide représentant le nœud précédant le nœud à insérer.
Renvoie
Vide
Application
list, classe
Version
XFA 2.1
Exemples
JavaScript
xfa.datasets.connectionData.DataConnection.nodes.insert(oHeader,oFirst);
FormCalc
xfa.datasets.connectionData.DataConnection.nodes.insert(oHeader,oFirst)
Méthodes de script
5.1.54. insertInstance
Insère une nouvelle instance d’un sous-formulaire ou d’un jeu de sous-formulaires à un formulaire.
Syntaxe
Reference_Syntax.insertInstance( INTEGER param1 [, BOOLEEN param2 ] )
Paramètres
param1 Entier spécifiant la position de l’index de base zéro pour insérer l’instance au sein d’un jeu d’instances.
param2(facultatif)
Valeur booléenne indiquant si les données doivent être fusionnées avec la nouvelle instance de sous-formulaire.
• true | 1(JavaScript) ou 1(FormCalc)
• Fusionne la nouvelle instance de sous-formulaire avec les données disponibles.
• false | 0(JavaScript) ou 0(FormCalc)
• La nouvelle instance de sous-formulaire n’est pas fusionnée avec les données.
Renvoie
Objet représentant la nouvelle instance du sous-formulaire ou du jeu de sous-formulaires.
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
606
Méthodes de script 5
Exemples
JavaScript
607
Subform1.instanceManager.insertInstance(3, 0);
FormCalc
Subform1.instanceManager.insertInstance(3, 0)
5.1.55. isBOF
Détermine si l’emplacement actuel se trouve au début du jeu d’enregistrements. La propriété bofAction doit être définie surstayBOF.
Syntaxe
Reference_Syntax.isBOF()
Paramètres
Aucun
Renvoie
True si l’emplacement actuel se trouve au début du jeu d’enregistrements. False si l’emplacement actuel ne se trouve pas au début du jeu d’enregistrements.
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Méthodes de script
Exemples
JavaScript
xfa.sourceSet.nodes.item(nIndex).isBOF();
FormCalc
xfa.sourceSet.nodes.item(nIndex).isBOF()
5.1.56. isCompatibleNS
Détermine si un espace de noms spécifié fonctionne, c’est-à-dire est compatible avec l’espace de noms de ce modèle. Détermine si les deux espaces de noms sont équivalents, même si les chaînes qui les représentent ne sont pas identiques.
Syntaxe
Reference_Syntax.isCompatibleNS( STRING param )
Paramètres
param Chaîne valide représentant l’espace de noms à comparer.
Renvoie
Truesi les espaces de noms sont équivalents, False s’ils ne sont pas compatibles.
Application
model, classe classe
Version
XFA 2.1
608
Méthodes de script 5
5.1.57. isEOF
609
Détermine si l’emplacement actuel se trouve à la fin du jeu d’enregistrements. La propriété eofAction doit être définie sur stayEOF.
Syntaxe
Reference_Syntax.isEOF()
Paramètres
Aucun
Renvoie
True si l’emplacement actuel se trouve à la fin du jeu d’enregistrements. False si l’emplacement actuel ne se trouve pas à la fin du jeu d’enregistrements.
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Exemples
JavaScript
xfa.sourceSet.nodes.item(nIndex).isEOF();
FormCalc
xfa.sourceSet.nodes.item(nIndex).isEOF()
Méthodes de script
5.1.58. isPropertySpecified
Vérifie si une propriété spécifique a été définie pour ce nœud.
Syntaxe
Reference_Syntax.isPropertySpecified( STRING param1 [, BOOLEEN param2 [, INTEGER param3 ] ] )
Paramètres
param1 Chaîne valide représentant le nom de la propriété de l’objet à rechercher.
param2 (Facultatif)
Valeur booléenne indiquant si l’héritage des classes parents doit être pris en compte.
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Détermine si cette propriété est héritée d’une classe parent.
• false | 0(JavaScript) ou 0(FormCalc)
• Détermine si cette propriété est définie pour l’objet actuel, indépendamment de l’héritage.
param3 (Facultatif)
Valeur entière spécifiant l’occurrence de la propriété à examiner. Ce paramètre est seulement valide pour les propriétés possédant plusieurs occurrences.
Renvoie
True si la propriété est spécifiée, false dans le cas contraire.
Application
node, classe classe
Version
XFA 2.1
610
Méthodes de script 5
Exemples
JavaScript
611
TextField1.isPropertySpecified("ui");
FormCalc
TextField1.isPropertySpecified("ui")
5.1.59. isRecordGroup
Indique si un objet dataGroup particulier est également un enregistrement unique.
Syntaxe
Reference_Syntax.isRecordGroup( OBJECT param )
Paramètres
param Objet dataGroup valide issu de la source de données actuelles.
Renvoie
True si le groupe de données spécifié est également un enregistrement unique, false dans le cas contraire.
Application
Modèle Objet
Modèle de données dataWindow
Version
XFA 2.1
Méthodes de script
Exemples
JavaScript
xfa.dataWindow.isRecordGroup(xfa.datasets.data.dataNodeName);
FormCalc
xfa.dataWindow.isRecordGroup(xfa.datasets.data.dataNodeName)
5.1.60. item
Décrit un index à base zéro dans la collection.
Syntaxe
Reference_Syntax.item( INTEGER param )
Paramètres
param Index à base zéro dans la collection.
Renvoie
Un objet représentant une arborescence XFA.
Application
list, classe
Version
XFA 2.1
LIENS CONNEXES :Référence aux objetsModification de la couleur d’arrière-planRemplissage d’une liste déroulanteDésactivation de tous les champs d’un formulaire
612
Méthodes de script 5
5.1.61. last
613
Accède au dernier enregistrement du jeu d’enregistrements et remplit le modèle de données avec les données d’enregistrement.
REMARQUE : La méthode de connexion aux données xfa.sourceSet.DataConnection.last effectue une recherche dans un tableau et le met à jour en cas de modification des données. Elle utilise la méthode hasDataChanged afin de déterminer si les données ont changé.
Syntaxe
Reference_Syntax.last()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Exemples
JavaScript
xfa.sourceSet.dataConnectionName.last();
FormCalc
xfa.sourceSet.dataConnectionName.last()
Méthodes de script
5.1.62. loadXML
Charge et ajoute un document XML spécifié à l’objet actif.
Syntaxe
Reference_Syntax.loadXML( STRING param1 [, BOOLEEN param2 [, BOOLEEN param3 ] ] )
Paramètres
param1 Chaîne valide représentant le document XML.
param2 (Facultatif)
Valeur booléenne indiquant si le nœud racine au sein du document XML doit être ignoré.
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Ignore le nœud racine du document XML et ajoute les autres nœuds XML directement dans l’objet de modèle d’objet de formulaire XML actif.
• false | 0(JavaScript) ou 0(FormCalc)
• Ajoute le nœud racine du document XML directement dans l’objet de modèle d’objet de formulaire XML actif.
param3 (Facultatif)
Valeur booléenne indiquant si les données issues du document XML doivent remplacer les informations de l’objet de modèle d’objet de formulaire XML actif.
• true | 1(JavaScript) ou 1(FormCalc)
• Remplace le contenu de l’objet de modèle d’objet de formulaire XML actif par les données du document XML.
• false | 0(JavaScript) ou 0(FormCalc) (par défaut)
• Ajoute les données de document XML dans l’objet de modèle d’objet de formulaire XML actif.
Renvoie
Vide
Application
node, classe classe
614
Méthodes de script 5
Version
615
XFA 2.1
Exemples
JavaScript
xfa.datasets.data.loadXML(xmlData,0,1);
FormCalc
xfa.datasets.data.loadXML(xmlData,0,1)
5.1.63. messageBox
Affiche à l’écran une boîte de dialogue. Cette méthode est uniquement disponible pour les applications client.
Syntaxe
Reference_Syntax.messageBox( STRING param1 [, CHAINE param2 [, INTEGER param3 [, INTEGER param4 ] ] ] )
Paramètres
param1 Chaîne valable représentant le message à afficher.
param2 (Facultatif)
Chaîne valable représentant le titre à afficher sur la barre de titre de la boîte de dialogue.Pour vous aider à vous protéger contre un programme espion provenant d’Internet, le titre de la boîte de dialogue commence par « Avertissement : fenêtre JavaScript ». Le titre de la fenêtre dans laquelle vous indiquez ce paramètre apparaît après affichage du texte d’avertissement.
param3 (Facultatif)
Entier représentant l’icône à afficher dans la boîte de dialogue.
• 0(Erreur) - Il s’agit de la valeur par défaut.
• 1(Avertissement)
• 2(Question)
• 3(Etat)
Méthodes de script
Les paramètres param2, param3et param4 sont facultatifs ; pour inclure l’un d’eux, vous devez toutefois insérer tous les paramètres qui le précèdent. Par exemple, le script JavaScript suivant est incorrect :
xfa.host.messageBox("Hello World!",3,1);
Dans ce cas, vous devez indiquer une valeur pour param2 afin que le script JavaScript s’exécute correctement.
param4 (Facultatif)
Entier représentant les boutons à afficher.
• 0(OK) - Il s’agit de la valeur par défaut.
• 1(OK, Annuler)
• 2(oui, non)
• 3(Oui, Non, Annuler)
Renvoie
Entier valide représentant la valeur du bouton activé par l’utilisateur :
• 1 (OK)
• 2 (Annuler)
• 3 (Non)
• 4 (Oui)
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
616
Méthodes de script 5
Exemples
JavaScript
617
xfa.host.messageBox("This is a message", "This is a title", 3, 1);
FormCalc
xfa.host.messageBox("This is a message", "This is a title", 3, 1)
LIENS CONNEXES :Création d’un nœud dans le modèle de donnéesRemplissage d’une liste déroulanteRendre un objet visible ou invisibleUtilisation des cases d’option et des cases à cocherDétermination de la modification d’un formulaire
5.1.64. metadata
Collecte un paquet de métadonnées XMP (Extensible Metadata Platform) complet pour le document.
Les métadonnées tierces sont collectées et converties au format XMP comme suit :
• Tous les éléments sont donnés dans l’espace de noms http://ns.adobe.com/xfa/promoted-desc/, avec le préfixe suggéré desc:.
• La valeur de l’objet name devient le nom de l’objet.
• Un qualificateur de propriété desc:ref est ajouté, sa valeur est une expression XPath pointant de nouveau vers le parent desc. L’ordre des objets desc dans un seul parent n’est pas conservé. Plusieurs objets desc du même nom ne sont pas collectés. Seul le premier objet desc est affiché dans la sortie.
Méthodes de script
• Le contenu sous l’objet desc est converti comme suit :
Lorsque le fichier XDP est généré en fichier PDF, les métadonnées collectées sont écrites dans le paquet XMP du fichier PDF. Les copies des mêmes métadonnées continuent d’exister dans le flux XFA du fichier PDF.
Objet Type XMP
boolean Booléen
date Date
dateTime Date
decimal Réel(le)
exData externe:URIincorporée:vignette
float Réel(le)
image externe:URIincorporée:vignette
integer Entier
text Texte
time Date
Syntaxe
Reference_Syntax.metadata ( INTEGER param )
Paramètres
param (Facultatif) Un entier représentant le format de numérotation.
• 0(RDF) (par défaut)
• 1(PlainXMP)
Renvoie
Une chaîne valable représentant la numérotation XML des métadonnées XMP.
618
Méthodes de script 5
Application
619
Modèle Objet
Modèle de formulaire desctemplate
Version
XFA 2.5
5.1.65. moveCurrentRecord
Place l’enregistrement actif dans un autre emplacement dans la plage des enregistrements.
Syntaxe
Reference_Syntax.moveCurrentRecord( INTEGER param )
Paramètres
param Entier valide représentant le nombre d’enregistrements séparant l’enregistrement actif de l’enregistrement cible voulu. Une valeur positive indique un enregistrement situé entre l’enregistrement actif et la fin de la plage des enregistrements, une valeur négative indique un enregistrement entre l’enregistrement actif et le début de la plage.
Renvoie
Vide
Application
Modèle Objet
Modèle de données dataWindow
Méthodes de script
Version
XFA 2.1
Exemples
JavaScript
xfa.dataWindow.moveCurrentRecord(1);
FormCalc
xfa.dataWindow.moveCurrentRecord(1)
Pour un exemple de l’utilisation de la méthode moveCurrentrecord en vue de consulter des enregistrements de données, reportez-vous à l’exemple Browsing records stored in a data file disponible sur ww.adobe.com/go/dev_lc_scripting_samples.
5.1.66. moveInstance
Déplace un objet subform au sein d’un jeu d’instances de sous-formulaire.
Les informations du modèle de données correspondantes sont également déplacées dans le modèle de données.
Syntaxe
Reference_Syntax.moveInstance( INTEGER param1, INTEGER param2 )
Paramètres
param1 Entier valide représentant la position de l’index de base 0 de l’objet de modèle de formulaire à déplacer.
param2 Entier valide représentant la position de base 0 de l’objet enfant au sein du jeu des instances.
Renvoie
Vide
620
Méthodes de script 5
Application
621
Modèle Objet
Modèle de formulaire instanceManager
Version
XFA 2.1
Exemples
JavaScript
Subform1.instanceManager.moveInstance(0,6);
FormCalc
Subform1.instanceManager.moveInstance(0,6)
LIENS CONNEXES :Manipulation des instances d’un sous-formulaire
5.1.67. namedItem
Récupère le premier enfant du nœud portant le nom donné.
Syntaxe
Reference_Syntax.namedItem( STRING param )
Paramètres
param Chaîne valide représentant le nom de ce nœud.
Renvoie
Objet représentant le premier enfant de ce nœud portant le nom donné.
Méthodes de script
Application
treeList, classe classe
Version
XFA 2.1
5.1.68. next
Accède à l’enregistrement suivant du jeu d’enregistrements et remplit le modèle de données avec les données d’enregistrement.
REMARQUE : La méthode de connexion aux données xfa.sourceSet.DataConnection.next effectue une recherche dans un tableau et le met à jour en cas de modification des données. Elle utilise la méthode hasDataChanged afin de déterminer si les données ont changé.
Syntaxe
Reference_Syntax.next()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
622
Méthodes de script 5
Exemples
JavaScript
623
xfa.sourceSet.dataConnectionName.next();
FormCalc
xfa.sourceSet.dataConnectionName.next()
5.1.69. open
Etablit la connexion à la source de données et remplit le modèle de données avec les résultats de l’enregistrement actuel.
Syntaxe
Reference_Syntax.open()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Méthodes de script
Exemples
JavaScript
xfa.sourceSet.nodes.item(nIndex).open();
FormCalc
xfa.sourceSet.nodes.item(nIndex).open()
5.1.70. openList
Ouvre une liste déroulante spécifiée par l’expression de syntaxe de référence.
Cette méthode est uniquement disponible pour les applications client.
Syntaxe
Reference_Syntax.openList( OBJECT param ) Reference_Syntax.openList( STRING param ) (deprecated)
Paramètres
param Expression de syntaxe de référence complète spécifiant une liste déroulante.
Renvoie
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.6
XFA 2.1 (désapprouvé)
624
Méthodes de script 5
5.1.71. page
625
Détermine le numéro de page où figure l’objet de conception de formulaire donné. Si l’objet occupe plusieurs pages, cette méthode renvoie la première page.
Syntaxe
Reference_Syntax.page( OBJECT param )
Paramètres
param L’expression de syntaxe de référence complète d’un des objets de conception de formulaire de conteneur suivant : field, draw, subform, area, pageArea, contentArea.
Renvoie
Entier représentant le nombre de pages logique (en fonction du nombre de page initial) contenant l’objet de formulaire spécifié. Cette méthode renvoie 0 si l’objet spécifié dans param est introuvable sur le formulaire.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.layout.page(this);
Méthodes de script
FormCalc
xfa.layout.page($)
LIENS CONNEXES :Utilisation de la numérotation des pages et du nombre de pages
5.1.72. pageContent
Récupère les types d’objet de conception de formulaire à partir d’une page donnée d’un formulaire.
Syntaxe
Reference_Syntax.pageContent( INTEGER param1 [, CHAINE param2 [, BOOLEEN param3 ] ] )
Paramètres
param1 Entier représentant le nombre de pages souhaité. Il s’agit d’une valeur de base 0.
param2 (Facultatif)
Renvoie les types suivants de conteneur :
• field
• Renvoie tous les objets de création de formulaire suivants : bouton, case à cocher, champ Date/Heure, liste, champ de signature, champ d’image, zone de liste, champ numérique, champ Mot de passe, bouton radio, champ de texte.
• draw
• Renvoie tous les objets de création de formulaire suivants : cercle, ligne, rectangle, image statique, texte statique.
• subform
• Renvoie tous les objets de conception de sous-formulaire.
• area
• Renvoie tous les objets de conception de formulaire associés à une zone.
626
Méthodes de script 5
627
param2 (Facultatif)
• pageArea
• Renvoie tous les objets de conception de formulaire de zone de page.
• contentArea
• Renvoie tous les objets de conception de formulaire associés à la zone de contenu.
• vide(par défaut)
• Renvoie tous les conteneurs.
param3 (Facultatif)
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Renvoie uniquement les nœuds de contenu pageArea.
• false | 0(JavaScript) ou 0(FormCalc)
• Renvoie tous les nœuds de contenu non pageArea.
Renvoie
Collection d’objets de conception de formulaire à partir du numéro de page spécifié.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
// Obtenir les champs d’un document var oFields = xfa.layout.pageContent(i, "field");
Méthodes de script
FormCalc
// Obtenir les champs d’un document var oFields = xfa.layout.pageContent(i, "field")
LIENS CONNEXES :Référence aux objetsDésactivation de tous les champs d’un formulaire
5.1.73. pageCount
Détermine le nombre de pages du formulaire actuel.
Syntaxe
Reference_Syntax.pageCount()
Paramètres
Aucun
Renvoie
Entier représentant le nombre total de pages du formulaire.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.layout.pageCount();
628
Méthodes de script 5
FormCalc
629
xfa.layout.pageCount()
LIENS CONNEXES :Référence aux objetsUtilisation de la numérotation des pages et du nombre de pagesDésactivation de tous les champs d’un formulaire
5.1.74. pageDown
Atteint la page suivante d’un formulaire. Utilisez la méthode pageDown au moment de l’exécution.
Syntaxe
Reference_Syntax.pageDown()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.host.pageDown();
Méthodes de script
FormCalc
xfa.host.pageDown()
LIENS CONNEXES :Utilisation de la numérotation des pages et du nombre de pages
5.1.75. pageSpan
Détermine le nombre de pages logiques utilisé par un objet de conception de formulaire donné.
Syntaxe
Reference_Syntax.pageSpan( OBJECT param )
Paramètres
param Expression de syntaxe de référence complète de l’un des objets conteneur de conception de formulaire suivants :
• area
• contentArea
• draw
• field
• pageArea
• subform
Renvoie
Entier représentant le nombre de pages logiques qu’occupe un objet de formulaire. Par exemple, admettons qu’un formulaire de 8 pages contienne un objet présent uniquement sur les pages 2, 4, 5 et 6. Dans ce cas, cette méthode renvoie la valeur 5, c’est-à-dire le nombre de pages sur lesquelles s’étend l’objet.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
630
Méthodes de script 5
Version
631
XFA 2.1
Exemples
JavaScript
xfa.layout.pageSpan(this);
FormCalc
xfa.layout.pageSpan($)
5.1.76. pageUp
Atteint la page précédente d’un formulaire. Utilisez la méthode pageUp au moment de l’exécution.
Syntaxe
Reference_Syntax.pageUp()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Méthodes de script
Exemples
JavaScript
xfa.host.pageUp();
FormCalc
xfa.host.pageUp()
LIENS CONNEXES :Utilisation de la numérotation des pages et du nombre de pages
5.1.77. previous
Accède à l’enregistrement précédent du jeu d’enregistrements et remplit le modèle de données avec les données d’enregistrement.
REMARQUE : La méthode de connexion aux données xfa.sourceSet.DataConnec-tion.previous effectue une recherche dans un tableau et le met à jour en cas de modification des données. Elle utilise la méthode hasDataChanged afin de déterminer si les données ont changé.
Syntaxe
Reference_Syntax.previous()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
632
Méthodes de script 5
Version
633
XFA 2.1
Exemples
JavaScript
xfa.sourceSet.dataConnectionName.previous();
FormCalc
xfa.sourceSet.dataConnectionName.previous()
5.1.78. print
Imprime un nombre de pages spécifique à partir d’un document. Cette méthode est uniquement disponible pour les applications client.
Syntaxe
Reference_Syntax.print( BOOLEAN param1, INTEGER param2, INTEGER param3, BOOLEEN param4, BOOLEEN param5, BOOLEEN param6, BOOLEAN param7, BOOLEEN param8 )
Paramètres
param1 • true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Affiche une boîte de dialogue d’impression et invite l’utilisateur à préciser les informations de configuration de l’impression et à confirmer l’opération.
• false | 0(JavaScript) ou 0(FormCalc)
• N’affiche pas de boîte de dialogue d’impression L’impression démarre sans que l’utilisateur n’ait à fournir d’informations ni à confirmer l’opération.
param2 Chaîne valide représentant le numéro de la première page de la série à imprimer. Les valeurs de page étant calculées sur la base 0, vous devez représenter la page 1 par la valeur 0.La page de début est incluse dans la série à imprimer.
Méthodes de script
param3 Chaîne valide représentant le numéro de la dernière page de la série à imprimer. Les valeurs de page étant calculées sur la base 0, vous devez représenter la page 1 par la valeur 0.La page de fin est incluse dans l’impression.
param4 • true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• N’affiche pas de boîte de dialogue d’annulation lors de processus d’impression.
• false | 0(JavaScript) ou 0(FormCalc)
• Affiche une boîte de dialogue d’annulation permettant d’inter-rompre l’impression.
param5 • true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Réduit la page (si nécessaire) afin de l’ajuster à la zone visible de la page imprimée.
• false | 0(JavaScript) ou 0(FormCalc)
• Ne réduit pas la page pour l’ajuster à la zone visible de la page imprimée.
param6 • true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Imprime chaque page comme une image.
• false | 0(JavaScript) ou 0(FormCalc)
• Imprime chaque page comme une page de texte.
param7 • true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Imprime les pages dans l’ordre inverse.
• false | 0(JavaScript) ou 0(FormCalc)
• Imprime les pages dans l’ordre.
param8 • true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Imprime toutes les annotations.
• false | 0(JavaScript) ou 0(FormCalc)
• N’imprime pas les annotations.
Renvoie
Vide
634
Méthodes de script 5
Application
635
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.host.print(1, "0", "0", 0, 1, 0, 0, 0);
FormCalc
xfa.host.print(1, "0", "0", 0, 1, 0, 0, 0)
5.1.79. recalculate
Force l’exécution d’un jeu spécifique de scripts sur des événements de calculs. Les événements spécifiques peuvent être des événements de calculs en attente ou l’intégralité des événements de calculs.
Syntaxe
Reference_Syntax.recalculate( BOOLEAN param )
Paramètres
param Une valeur booléenne indique les scripts de calcul à exécuter.
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Tous les scripts de calcul sont à nouveau exécutés.
• false | 0(JavaScript) ou 0(FormCalc)
• Seuls les scripts de calcul en attente doivent être exécutés.
Méthodes de script
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire formulairetemplate
Version
XFA 2.1
Exemples
JavaScript
xfa.form.recalculate(1);
FormCalc
xfa.form.recalculate(1)
5.1.80. record
Renvoie un enregistrement dans une position relative à l’enregistrement actif.
Syntaxe
Reference_Syntax.record( INTEGER param )
Paramètres
param Entier valide représentant le nombre d’enregistrements séparant l’enregistrement actif de l’enregistrement cible voulu. Une valeur positive indique un enregistrement situé entre l’enregistrement actif et la fin de la plage des enregistrements, une valeur négative indique un enregistrement entre l’enregistrement actif et le début de la plage.
636
Méthodes de script 5
Renvoie
637
Objet
Application
Modèle Objet
Modèle de données dataWindow
Version
XFA 2.1
Exemples
JavaScript
xfa.dataWindow.record(0).dataNodeName.value;
FormCalc
xfa.dataWindow.record(0).dataNodeName.value
LIENS CONNEXES :Création d’un nœud dans le modèle de donnéesConcaténation de valeurs de données Remplissage d’une liste déroulante
5.1.81. relayout
Applique à nouveau les options de disposition au formulaire actif.
Syntaxe
Reference_Syntax.relayout()
Paramètres
Aucun
Méthodes de script
Renvoie
Vide
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.layout.relayout();
FormCalc
xfa.layout.relayout()
5.1.82. relayoutPageArea
Remplace la disposition du contenu de l’objet pageArea par une nouvelle disposition.
Syntaxe
Reference_Syntax.relayoutPageArea( [ INTEGER param ] )
Paramètres
param(Facultatif)
Numéro de la page à substituer. Les valeurs de numéro de page sont à base 0.
638
Méthodes de script 5
Renvoie
639
Vide
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.layout.relayoutPageArea(0);
FormCalc
xfa.layout.relayoutPageArea(0)
5.1.83. remerge
Force la fusion des modèles de données et la conception de modèle pour recréer un modèle de formulaire. Une fois la fusion effectuée, tout traitement de modèle de disposition doit être à nouveau effectué pour déterminer le formulaire.
Syntaxe
Reference_Syntax.remerge()
Paramètres
Aucun
Méthodes de script
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire formulaire
Version
XFA 2.1
Exemples
JavaScript
xfa.form.remerge();
FormCalc
xfa.form.remerge()
5.1.84. remove
Supprime un nœud de la liste.
Syntaxe
Reference_Syntax.remove( OBJECT param )
Paramètres
param Expression de syntaxe de référence valide représentant le nœud à supprimer.
640
Méthodes de script 5
Renvoie
641
Vide
Application
list, classe
Version
XFA 2.1
Exemples
JavaScript
xfa.record.nodes.remove(oNode);
FormCalc
xfa.record.nodes.remove(oNode)
LIENS CONNEXES :Création d’un nœud dans le modèle de données
5.1.85. removeAttribute
Supprime un attribut XML dans un paquet XML tiers personnalisé ajouté à la source XML d’une conception de formulaire.
Syntaxe
Reference_Syntax.removeAttribute( STRING param )
Paramètres
param Chaîne valide représentant le nom de la propriété à supprimer.
Méthodes de script
Renvoie
Vide
Application
Modèle Objet
Modèle XFA packet
Version
XFA 2.1
Exemples
À l’aide d’un paquet XML personnalisé appelé myCustomPacket avec un attribut nommé id, il est possible de supprimer l’attribut à l’aide des scripts suivants :
JavaScript
xfa.myCustomPacket.removeAttribute("id");
FormCalc
xfa.myCustomPacket.removeAttribute("id")
5.1.86. removeInstance
Supprime un sous-formulaire ou un jeu de sous-formulaires spécifique du modèle de formulaire.
Lors de la suppression d’une instance de sous-formulaire, évitez les violations d’occurrences de sous-formulaire. En effet, vous ne pouvez pas supprimer d’instance de sous-formulaire lorsque le nombre minimum d’instances a été atteint. Lorsque cette valeur minimale est atteinte pour un sous-formulaire, le débogueur JavaScript affiche un message d’erreur :
L’élément [min] a dépassé le nombre d’occurrences autorisé.
Si l’utilisateur final est autorisé à supprimer toutes les instances d’un sous-formulaire, réinitialisez le nombre minimum d’instances sur la valeur0avant de tenter de supprimer une instance. A défaut, le script empêchera toute tentative de suppression d’instances de sous-formulaire en deçà du nombre minimum.
642
Méthodes de script 5
Syntaxe
643
Reference_Syntax.removeInstance( INTEGER param )
Paramètres
param Entier valide représentant la position de l’index de base de 0 au sein d’un modèle de formulaire pour le sous-formulaire ou jeu de sous-formulaires à supprimer.
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire instanceManager
Version
XFA 2.1
Exemples
JavaScript
Subform2.instanceManager.removeInstance(3);
FormCalc
Subform2.instanceManager.removeInstance(3)
LIENS CONNEXES :Manipulation des instances d’un sous-formulaire
Méthodes de script
5.1.87. requery
Met à jour la liaison active des données en exécutant à nouveau la requête sur laquelle reposent les données d’objet. L’appel de cette méthode équivaut à appeler les méthodes close et open l’une après l’autre.
Syntaxe
Reference_Syntax.requery()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
5.1.88. reset
Réinitialise toutes les propriétés dans le modèle d’événement du formulaire XML.
Syntaxe
Reference_Syntax.reset()
Paramètres
Aucun
644
Méthodes de script 5
Renvoie
645
Vide
Application
Modèle Objet
Modèle Event eventPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.event.reset();
FormCalc
xfa.event.reset()
5.1.89. resetData
Rétablit les valeurs par défaut des champs dans un document.
Syntaxe
Reference_Syntax.resetData([ STRING param ])
Paramètres
param(Facultatif)
Chaîne valide répertoriant soit les noms soit les expressions de syntaxe de référence équivalentes des champs à réinitialiser. Les entrées de liste sont délimitées par le caractère « , » (virgule). Si la chaîne est absente ou vide, tous les champs du formulaire sont réinitialisés selon leur valeur par défaut.
Méthodes de script
Renvoie
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.host.resetData("xfa.form.form1.TextField1,xfa.form.form1.TextField2");
FormCalc
xfa.host.resetData("xfa.form.form1.TextField1,xfa.form.form1.TextField2")
5.1.90. resolveNode
Evalue l’expression de syntaxe de référence spécifiée, en commençant par l’objet modèle de l’objet de formulaire XML actif et renvoie la valeur de l’objet spécifié dans l’expression de syntaxe de référence.
La recherche d’un objet commence à un point différent dans la hiérarchie de formulaires, selon le mode utilisé pour accéder à la propriété resolveNode :
• this.resolveNode() La recherche commence à partir de l’objet actif et remonte la hiérarchie du formulaire.
• xfa.resolveNode() La recherche commence en haut de la hiérarchie du formulaire et progresse vers le bas.
REMARQUE : la recherche peut renvoyer des résultats inattendus si le formulaire contient plusieurs objets utilisant le même nom. Elle renvoie la valeur du premier objet trouvé.
646
Méthodes de script 5
Syntaxe
647
Reference_Syntax.resolveNode( STRING param )
Paramètres
param Chaîne valide représentant une expression de syntaxe de référence renvoyant un objet de modèle d’objet de formulaire XML spécifique.
Renvoie
Objet unique correspondant à l’expression de syntaxe de référence (s’il existe). En l’absence d’un tel objet, cette méthode renvoie la chaîne null.
Application
tree, classe classe
Version
XFA 2.1
Exemples
JavaScript
xfa.resolveNode("#subform").x = "2in";
TextField1.resolveNode("ui.#textEdit").border.edge.stroke = "lowered";
LIENS CONNEXES :Référence aux objetsCréation d’un nœud dans le modèle de donnéesManipulation des instances d’un sous-formulaireRemplissage d’une liste déroulante
Méthodes de script
5.1.91. resolveNodes
Evalue l’expression de syntaxe de référence spécifiée, en commençant par l’objet modèle de l’objet de formulaire XML actif et renvoie la valeur de l’objet ou des objets spécifiés dans l’expression de syntaxe de référence.
La recherche d’un objet commence à un point différent dans la hiérarchie de formulaires, selon le mode utilisé pour accéder à la propriété resolveNode :
• this.resolveNodes() La recherche commence à partir de l’objet actif et remonte la hiérarchie du formulaire.
• xfa.resolveNodes() La recherche commence en haut de la hiérarchie du formulaire et progresse vers le bas.
REMARQUE : la recherche peut renvoyer des résultats inattendus si le formulaire contient plusieurs objets utilisant le même nom. Elle renvoie la valeur du premier objet trouvé.
Syntaxe
Reference_Syntax.resolveNodes( STRING param )
Paramètres
param Chaîne valide représentant une expression de syntaxe de référence renvoyant à un ou plusieurs objets de modèle d’objet de formulaire XML spécifiques.
Renvoie
Objet unique correspondant à l’expression de syntaxe de référence (s’il existe). En l’absence d’un tel objet, cette méthode renvoie la chaîne vide.
Application
tree, classe classe
Version
XFA 2.1
648
Méthodes de script 5
Exemples
JavaScript
649
xfa.resolveNodes("Subform1[*]");
FormCalc
xfa.resolveNodes("Subform1[*]")
LIENS CONNEXES :Référence aux objetsConcaténation de valeurs de données Utilisation des cases d’option et des cases à cocher
5.1.92. response
Affiche une boîte de dialogue contenant une question et un champ de saisie permettant à l’utilisateur de répondre à la question. La valeur renvoyée est une chaîne contenant la réponse de l’utilisateur. Si l’utilisateur clique sur le bouton Annuler dans la boîte de dialogue, la réponse est nulle.
Syntaxe
Reference_Syntax.response(STRING param1 [, CHAINE param2 [, CHAINE param3 [, BOOLEEN param4 ] ] ])
Paramètres
param1 Chaîne valide représentant une question adressée à l’utilisateur.
param2 (Facultatif)
Chaîne valide représentant le titre figurant sur la barre de titre de la boîte de dialogue.
param3 (Facultatif)
Chaîne valide représentant la valeur par défaut de la réponse à la question.
param4 (Facultatif)
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Masque la réponse de l’utilisateur avec des * (astérisques).
• false | 0(JavaScript) ou 0(FormCalc)
• Ne masque pas la réponse de l’utilisateur.
Méthodes de script
Renvoie
Chaîne représentant la réponse de l’utilisateur. Si l’utilisateur clique sur le bouton Annuler dans la boîte de dialogue, la réponse correspond à l’objet null.
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.1
Exemples
JavaScript
xfa.host.response("Question", "Title", "Default Value");
FormCalc
xfa.host.response("Question", "Title", "Default Value")
5.1.93. restore
Met à jour la valeur actuelle de la propriété en la remplaçant par la valeur enregistrée.
Le script effectue toutes les validations nécessaires avant d’appeler la propriété restore.
Syntaxe
Reference_Syntax.restore()
Paramètres
Aucun
650
Méthodes de script 5
Renvoie
651
Valeur nulle
Application
Modèle Objet
Modèle de formulaire
Version
XFA 2.5
5.1.94. resync
Actualise le jeu d’enregistrements actif ou la connexion aux données active.
Syntaxe
Reference_Syntax.resync()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Méthodes de script
Version
XFA 2.1
5.1.95. saveFilteredXML
Enregistre le nœud actif dans une chaîne, mais inclut uniquement un jeu partiel des nœuds enfant.
Syntaxe
Reference_Syntax.saveFilteredXML( OBJECT param1 [, "pretty" ] )
Paramètres
param1 Liste de nœuds comprenant le sous-jeu de nœuds à inclure dans la chaîne.
pretty(Facultatif)
Sort la chaîne XML dans un format plus facile à lire.
Renvoie
Chaîne valide représentant le fragment XML incluant uniquement le jeu partiel spécifié du nœud actif.
Application
node, classe
Version
XFA 2.4
652
Méthodes de script 5
5.1.96. saveXML
653
Enregistre la structure XML de la classe node actuelle dans une chaîne.
Syntaxe
Reference_Syntax.saveXML( [ "pretty" ] )
Paramètres
pretty(Facultatif)
Sort la chaîne XML dans un format plus facile à lire.
Renvoie
Chaîne valide représentant le fragment XML de l’objet actif.
Application
node, classe classe
Version
XFA 2.1
Exemples
JavaScript
xfa.data.saveXML(); xfa.data.saveXML("pretty");
FormCalc
xfa.data.saveXML() xfa.data.saveXML("pretty")
LIENS CONNEXES :Détermination de la modification d’un formulaire
Méthodes de script
5.1.97. selectedMember
Renvoie le membre sélectionné d’un groupe d’exclusion.
Syntaxe
Reference_Syntax.selectedMember( [ STRING param ] )
Paramètres
param(Facultatif)
Chaîne valide représentant le nom du membre du groupe d’exclusion, à condition que celui-ci soit dans la même plage que l’objet de référence. Sinon, chaîne représentant l’expression de syntaxe de référence du membre du groupe d’exclusion à sélectionner.
Renvoie
Objet représentant le membre sélectionné du groupe d’exclusion. Dans Designer, par exemple, cette méthode renvoie le bouton radio sélectionné.
Application
Modèle Objet
Modèle de formulaire exclGroup
Version
XFA 2.1
654
Méthodes de script 5
5.1.98. setAttribute
655
Définit la valeur d’une propriété spécifiée.
Syntaxe
Reference_Syntax.setAttribute( STRING param1, CHAINE param2 )
Paramètres
param1 Chaîne valide représentant la nouvelle valeur de la propriété.
param2 Chaîne valide représentant le nom de la propriété.
Renvoie
Vide
Application
S’applique également à la classe node, classe .
Modèle Objet
Modèle XFA packet
Version
XFA 2.1
Exemples
JavaScript
Subform1.border.setAttribute("open", "break");
Méthodes de script
5.1.99. setElement
Définit un objet spécifié sur l’objet actif.
Syntaxe
Reference_Syntax.setElement( OBJECT param1 [, CHAINE param2 ] )
Paramètres
param1 Objet représentant le nouvel objet.
param2 (Facultatif)
Chaîne valide représentant le nom de l’objet à remplacer.
Renvoie
Vide
Application
node, classe classe
Version
XFA 2.1
5.1.100. setFocus
Définit la sélection au clavier sur l’objet de formulaire défini par l’expression de syntaxe de référence.
Cette méthode est uniquement disponible pour les applications client.
Si l’argument param1 est omis ou nul, setFocus effectue une opération d’effacement de la sélection. Si un objet de formulaire est une cible d’action, la cible est supprimée de cet objet et les modifications en attente dans cet objet sont répercutées, remplissant le document de données non nécessaires le cas échéant. Si ces modifications entraînent une erreur de validation, cette erreur s’affiche. Si aucun objet de formulaire n’est une cible d’action, l’argument zéro setFocus n’effectue aucune opération.
Vous ne pouvez pas utiliser setFocus avec les événements form:ready, layout:ready, ou initialize.
656
Méthodes de script 5
Syntaxe
657
Reference_Syntax.setFocus( OBJECT param ) Reference_Syntax.setFocus( STRING param ) (deprecated)
Paramètres
param (Facultatif) Chaîne valide représentant une expression de syntaxe de référence complète pour l’objet de formulaire.
Renvoie
Vide
Application
Modèle Objet
Modèle Host hostPseudoModel
Version
XFA 2.6
XFA 2. 1 (obsolète)
Exemples
JavaScript
xfa.host.setFocus(xfa.form.form1.TextField1);
FormCalc
xfa.host.setFocus(“xfa.form.form1.TextField1”)
Méthodes de script
5.1.101. setInstances
Ajoute ou supprime les sous-formulaires ou jeux de sous-formulaires spécifiés du modèle de formulaire.
Syntaxe
Reference_Syntax.setInstance( INTEGER param )
Paramètres
param Entier valide représentant le nombre d’instances voulu d’un sous-formulaire ou d’un jeu de sous-formulaires dans le modèle de formulaire.
Renvoie
Vide
Application
Modèle Objet
Modèle de formulaire instanceManager
Version
XFA 2.1
Exemples
JavaScript
Subform1.instanceManager.setInstances(5);
FormCalc
Subform1.instanceManager.setInstances(5)
LIENS CONNEXES :Manipulation des instances d’un sous-formulaire
658
Méthodes de script 5
5.1.102. setItems
659
Ajoute de nouveaux éléments et de nouvelles valeurs au champ de formulaire actuel. Par exemple, cette méthode permet d’ajouter des éléments et des valeurs comme arguments à une liste déroulante.
Syntaxe
Reference_Syntax.setItems( STRING param1 [, INTEGER param2] )
Version
2.8
Paramètres
param1 Liste d’éléments et de valeurs séparés par une virgule. Par exemple : "Un,Deux,Trois "ou "Un,1,Deux,2,Trois,3". Dans le cas où les éléments ne comportent pas de valeurs, n’indiquez aucune valeur. Par exemple : "élément1,valeur1,élément2,,élément3".
param2 Nombre de colonnes par élément Par exemple, la chaîne itemValueList, Un,1,Deux,2,Trois,3 possède numColumns=2. La chaîne itemValueList Un,Uno,1,Deux,Due,2,Trois,Tre,3 possède numColumns=3 alors que la chaîne itemValueList Un,Deux,Trois possède numColumns=1. La valeur par défaut est 1.
Renvoie
True si la liste a été créée correctement, False si le nombre d’éléments ne correspond pas au nombre de colonnes.
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.8
Méthodes de script
5.1.103. setItemState
Définit l’état de sélection de l’élément spécifié.
Syntaxe
Reference_Syntax.setItemState( INTEGER param1, BOOL param2 )
Version
2.8
Paramètres
param1 Entier valide représentant l’index de base zéro dans l’élément.
param2 • true | 1(JavaScript) ou 1(FormCalc)
• Ajoute cet élément à la sélection actuelle.
• false | 0(JavaScript) ou 0(FormCalc)
• Supprime cet élément de la sélection actuelle.
Renvoie
Aucun
Application
Modèle Objet
Modèle de formulaire field
Version
XFA 2.5
660
Méthodes de script 5
5.1.104. sheet
661
Détermine le numéro de la feuille où figure l’objet de formulaire.
Certains documents recto verso utilisent des numéros de feuille afin de numéroter uniquement les surfaces recto. Par exemple, vous pouvez utiliser des numéros de feuille lorsque les surfaces recto contiennent des données variables et les surfaces verso contiennent le texte standard, notamment les instructions, les avis de non-responsabilité ou les légendes.
Syntaxe
Reference_Syntax.sheet( OBJECT param )
Version
2.5
Paramètres
param L’expression de syntaxe de référence complète d’un des objets de formulaire suivants : field, draw, subform, area, pageArea, contentArea.
Renvoie
Entier à base zéro représentant le numéro de feuille.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.5
Méthodes de script
5.1.105. sheetCount
Détermine le nombre de feuilles dans le formulaire actuel.
Syntaxe
Reference_Syntax.sheetCount( )
Version
2.5
Paramètres
Aucun
Renvoie
Entier représentant le nombre total de feuilles.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.5
5.1.106. sheetCountInBatch
Détermine le nombre de feuilles dans le lot actuel.
Syntaxe
Reference_Syntax.sheetCountInBatch( )
662
Méthodes de script 5
Version
663
2.5
Paramètres
Aucun
Renvoie
Un entier représentant la quantité de pages du lot actuel.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.5
5.1.107. sheetInBatch
Détermine la feuille du lot qui contient l’objet de formulaire.
Syntaxe
Reference_Syntax.sheetInBatch( OBJECT param )
Version
2.5
Paramètres
param L’expression de syntaxe de référence complète d’un des objets de formulaire suivants : field, draw, subform, area, pageArea, contentArea.
Méthodes de script
Renvoie
Entier représentant le nombre de feuilles contenant l’objet de formulaire.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.5
5.1.108. sign
Appose une signature à une liste de nœuds donnée et place la signature à l’emplacement cible.
Syntaxe
Reference_Syntax.sign( OBJECT param1, CHAINE param2, CHAINE param3 [, CHAINE param4 [, BOOLEEN param5 [, OBJECT param6 [, OBJECT param7 ] ] ] ] )
Paramètres
param1 input Liste valide des nœuds XFA pour tous les nœuds à signer.
param2 input Chaîne valide représentant une expression de syntaxe de référence du parent du nœud de signature.
param3 input Chaîne valide représentant une valeur d’identification XML de la signature.
param4 (Facultatif)
entrée (facultatif)
La seule valeur valide est open(par défaut). Elle indique que les nœuds de données sont ouverts pour modification et peuvent donc être manipulés lorsqu’ils sont exécutés.
664
Méthodes de script 5
665
param5 (Facultatif)
entrée (facultatif)
Indique s’il est nécessaire ou non d’utiliser une boîte de dialogue pour autoriser un utilisateur à signer un formulaire.
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Indique qu’une boîte de dialogue est utilisée pour cette opération.
• false | 0(JavaScript) ou 0(FormCalc)
• Indique qu’une boîte de dialogue n’est pas utilisée pour cette opération. Si vous spécifiez cette valeur, vous devez prévoir un autre gestionnaire de protection dans param6 de façon à ce que l’application hébergeant le formulaire puisse extraire le mot de passe et les infor-mations d’identification nécessaires lors de la signature du formulaire.
param6 (Facultatif)
entrée (facultatif)
Représente l’objet SecurityHandler utilisé pour les opérations de signature. Les objets de sécurité doivent en général être initialisés avant d’être utilisés pour des opérations de signature. Vous devez attribuer une valeur à ce paramètre si vous définissez param5 sur False.
param7 (Facultatif)
sortie (facultatif)
Représente l’objet SignatureInfo de sortie contenant les propriétés en écriture de la signature.
Renvoie
True true si la signature est apposée, False si la signature est annulée. Une exception est renvoyée si l’opération de signature échoue.
Application
Modèle Objet
Modèle de signature signaturePseudoModel
Version
XFA 2.1
Méthodes de script
Exemples
JavaScript
//Cet exemple signe tous les objets de formulaire qui contiennent actuellement des données. var oData = xfa.resolveNode("xfa.data.form1"); xfa.signature.sign(oData, "xfa.data.signatures", "mySignature");
FormCalc
//Cet exemple signe tous les objets de formulaire qui contiennent actuellement des données. var oData = xfa.resolveNode("xfa.data.form1") xfa.signature.sign(oData, "xfa.data.signatures", "mySignature")
5.1.109. update
Met à jour l’enregistrement actif dans le jeu d’enregistrements.
Syntaxe
Reference_Syntax.update()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
666
Méthodes de script 5
Exemples
JavaScript
667
xfa.sourceSet.dataConnectionName.update();
FormCalc
xfa.sourceSet.dataConnectionName.update()
5.1.110. updateBatch
Ecrit toutes les mises à jour du lot en attente dans la source de données.
Syntaxe
Reference_Syntax.updateBatch()
Paramètres
Aucun
Renvoie
Vide
Application
Modèle Objet
Modèle sourceSet source
Version
XFA 2.1
Méthodes de script
5.1.111. verify
Authentifie la signature.
Syntaxe
Reference_Syntax.verify( OBJECT param1 [, BOOLEEN param2 [, OBJECT param3 [, OBJECT param4 ] ] ] )
Paramètres
param1 input Nœud de signature XML valable.
param2 (Facultatif)
entrée (facultatif)
• true | 1(JavaScript) ou 1(FormCalc) (par défaut)
• Indique qu’une boîte de dialogue est utilisée pour cette opération.
• false | 0(JavaScript) ou 0(FormCalc)
• Indique qu’une boîte de dialogue n’est pas utilisée pour cette opération.
param3(Facultatif)
entrée (facultatif)
Objet SecurityHandler utilisé pour les opérations de signature. Les objets de sécurité doivent en général être initialisés avant d’être utilisés pour des opérations de signature.
param4 (Facultatif)
sortie (facultatif)
Objet SignatureInfo de sortie contenant les propriétés en écriture de la signature.
Renvoie
Entier représentant la validité de la signature ou exception si le nœud n’est pas un nœud de signature. Le tableau suivant décrit les valeurs valides :
Valeur Description
0 Signature vide.
1 Etat inconnu. Dans ce cas, aucune tentative de validation de la signature n’a été effectuée. Cela peut être lié à un problème logiciel ou matériel qui empêche la validation.
2 Signature non valable.
668
Méthodes de script 5
669
3 Signature valide, mais l’identité du signataire n’a pas pu être vérifiée.
4 La signature du document et l’identité du signataire sont valides.
Valeur Description
Application
Modèle Objet
Modèle de signature signaturePseudoModel
Version
XFA 2.1
Exemples
JavaScript
// Cet exemple examine la validité de tous les objets signés sur un formulaire. Pour //chaque objet signé, la valeur de renvoi d’entier de la méthode verify() // s’affiche dans un message. var oSigs = xfa.signature.enumerate(); var iNum = oSigs.length; for (var i=0; i < iNum; i++) { var oChild = oSigs.item(i); var iVerify = xfa.signature.signer(child); xfa.host.messageBox(iVerify); }
FormCalc
// Cet exemple examine la validité de tous les objets signés sur un formulaire. Pour //chaque objet signé, la valeur de renvoi d’entier de la méthode verify() // s’affiche dans un message. var oSigs = xfa.signature.enumerate() var iNum = oSigs.length - 1 for i=0 upto iNum step 1 do var oChild = oSigs.item(i) var iVerify = xfa.signature.signer(child) xfa.host.messageBox(iVerify) endfor
Méthodes de script
5.1.112. w
Détermine la largeur d’un objet de conception de formulaire donné.
Syntaxe
Reference_Syntax.w( OBJECT param1 [, CHAINE param2 [, INTEGER param3 ] ] )
Paramètres
param1 L’expression de syntaxe de référence complète de l’un des objets de modèle d’objet de formulaire XML suivants : area, contentArea, draw, field, pageArea, sous-formulaire.
param2 (Facultatif)
Chaîne représentant le type d’unité de la valeur renvoyée. Si le paramètre est vide, le type d’unité par défaut est points.
param3 (Facultatif)
Entier représentant une valeur d’index de base zéro indiquant la zone de contenu dans laquelle vous souhaitez obtenir la largeur de l’objet. Si aucune valeur n’est définie, la valeur par défaut est0.Ce paramètre permet de calculer la largeur d’un objet distribué dans plusieurs zones de contenu, telles que des pages. Par exemple, si vous souhaitez trouver la largeur d’un objet de sous-formulaire qui s’étend sur plusieurs zones de contenu, vous pouvez utiliser ce paramètre pour calculer la largeur du sous-formulaire dans chacune des zones de contenu et additionner les totaux.
Renvoie
Largeur de l’objet de conception de formulaire dans la zone de contenu actuelle.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
670
Méthodes de script 5
Exemples
JavaScript
671
// Renvoie la largeur d’une instance unique de TextField1 xfa.layout.w(TextField1,"in");
// Calcule la largeur de Subform1 dans deux zones de contenu et affiche // le total dans un message. var iWidth = xfa.layout.w(Subform1,"in",0) + xfa.layout.w(Subform1,"in",1); xfa.host.messageBox(iWidth);
FormCalc
// Renvoie la largeur d’une instance unique de TextField1 xfa.layout.w(TextField1,"in")
// Calcule la largeur de Subform1 dans deux zones de contenu et affiche // le total dans un message. var iWidth = xfa.layout.w(Subform1,"in",0) + xfa.layout.w(Subform1,"in",1) xfa.host.messageBox(iWidth)
5.1.113. x
Détermine la coordonnée x d’un objet de conception de formulaire donné par rapport à son objet parent.
Syntaxe
Reference_Syntax.x( OBJECT param1 [, CHAINE param2 [, INTEGER param3 ] ] )
Paramètres
param1 L’expression de syntaxe de référence complète de l’un des objets de modèle d’objet de formulaire XML suivants : area, contentArea, draw, field, pageArea, sous-formulaire.
param2 (Facultatif)
Chaîne représentant le type d’unité de la valeur renvoyée. Si le paramètre est vide, le type d’unité par défaut est points.
Méthodes de script
param3 (Facultatif)
Entier représentant une valeur d’index de base zéro indiquant la zone de contenu dans laquelle vous souhaitez obtenir la coordonnée x de l’objet. Si aucune valeur n’est définie, la valeur par défaut est0.Ce paramètre permet de calculer la coordonnée x d’un objet distribué dans plusieurs zones de contenu, telles que des pages. Par exemple, si vous souhaitez trouver la coordonnée x absolue d’un objet de sous-formulaire qui s’étend sur plusieurs zones de contenu, vous pouvez utiliser ce paramètre pour calculer la coordonnée x absolue du sous-formulaire dans chacune des zones de contenu et additionner les totaux.Si l’objet pour lequel vous souhaitez calculer une coordonnée x est imbriqué dans plusieurs couches d’objets parents, vous devez prendre en compte la coordonnée x de chaque objet parent lors du calcul de la coordonnée x réelle de l’objet.
Renvoie
La coordonnée x de l’objet de conception de formulaire par rapport à son objet parent.
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
// Renvoie la coordonnée x d’une instance unique de TextField1, par rapport à // son objet parent. xfa.layout.x(TextField1,"in");
// Calcule la coordonnée x de Subform1 dans deux zones de contenu et // affiche le total dans un message. var iX = xfa.layout.x(Subform1,"in",0) + xfa.layout.x(Subform1,"in",1); xfa.host.messageBox(iX);
672
Méthodes de script 5
FormCalc
673
// Renvoie la coordonnée x d’une instance unique de TextField1, par rapport à // son objet parent. xfa.layout.x(TextField1,"in")
// Calcule la coordonnée x de Subform1 dans deux zones de contenu et // affiche le total dans un message. var iX = xfa.layout.x(Subform1,"in",0) + xfa.layout.x(Subform1,"in",1) xfa.host.messageBox(iX)
5.1.114. y
Détermine la coordonnée y d’un objet de conception de formulaire donné par rapport à son objet parent.
Syntaxe
Reference_Syntax.y( OBJECT param1 [, CHAINE param2 [, INTEGER param3 ] ] )
Paramètres
param1 L’expression de syntaxe de référence complète de l’un des objets de modèle d’objet de formulaire XML suivants : area, contentArea, draw, field, pageArea, sous-formulaire.
param2 (Facultatif)
Chaîne représentant le type d’unité de la valeur renvoyée. Si le paramètre est vide, le type d’unité par défaut est points.
param3 (Facultatif)
Entier représentant une valeur d’index de base zéro indiquant la zone de contenu dans laquelle vous souhaitez obtenir la coordonnée y de l’objet. Si aucune valeur n’est définie, la valeur par défaut est0.Ce paramètre permet de calculer la coordonnée y d’un objet distribué dans plusieurs zones de contenu, telles que des pages. Par exemple, si vous souhaitez trouver la coordonnée y absolue d’un objet de sous-formulaire qui s’étend sur plusieurs zones de contenu, vous pouvez utiliser ce paramètre pour calculer la coordonnée y absolue du sous-formulaire dans chacune des zones de contenu et additionner les totaux.Si l’objet pour lequel vous souhaitez calculer une coordonnée y est imbriqué dans plusieurs couches d’objets parents, vous devez prendre en compte la coordonnée y de chaque objet parent lors du calcul de la coordonnée y réelle de l’objet.
Renvoie
Coordonnée y de l’objet de conception de formulaire sous la forme d’un double.
Méthodes de script
Application
Modèle Objet
Modèle Layout layoutPseudoModel
Version
XFA 2.1
Exemples
JavaScript
// Renvoie la coordonnée y d’une instance unique de TextField1, par rapport à // son objet parent. xfa.layout.y(TextField1,"in");
// Calcule la coordonnée y de Subform1 dans deux zones de contenu et // affiche le total dans un message. var iY = xfa.layout.y(Subform1,"in",0) + xfa.layout.y(Subform1,"in",1); xfa.host.messageBox(iY);
FormCalc
// Renvoie la coordonnée y d’une instance unique de TextField1, par rapport à // son objet parent. xfa.layout.y(TextField1,"in")
// Calcule la coordonnée y de Subform1 dans deux zones de contenu et // affiche le total dans un message. var iY = xfa.layout.y(Subform1,"in",0) + xfa.layout.y(Subform1,"in",1) xfa.host.messageBox(iY)
674
Méthodes de script 5
5.2. Méthodes de script pour les macros Designer
675
5.2.1. alert
Affiche une boîte de dialogue dans Designer avec le message « sMsg ».
Syntaxe
designer.alert( STRING param )
Paramètres
param Chaîne valide représentant le message à afficher dans la boîte de dialogue.
Renvoie
Vide.
5.2.2. callExternalFunction
Fournit une méthode permettant au script de macro d’appeler le code natif. Permet en général d’afficher une interface utilisateur graphique personnalisée développée avec une technologie autre que Flash.
Lorsque le script appelle callExternalFunction, le nom de fichier DLL spécifié est chargé à partir du dossier contenant le fichier de script en cours d’exécution. L’extension DLL est automatiquement ajoutée au nom de fichier spécifié. Le nom de fichier de la DLL ne peut pas inclure des éléments de chemin d’accès et doit inclure un nom du fichier sans extension, par exemple monExtensionde-Macro.
GetProcAddress est utilisé pour localiser la fonction identifiée par le paramètre sFunctionName.
Exemple d’appel :
designer.callExternalFunction("DesignerExtension", "ShowMyDialog", "user data here");
Cet appel charge une DLL appelée DesignerExtension.dll à partir du même répertoire que celui dans lequel la macro est installée, recherche une fonction appelée ShowMyDialog et transmet la chaîne « données utilisateur ici » sous forme de chaîne de caractères larges (const wchar_t *).
Méthodes de script
La fonction peut renvoyer une chaîne, qui est renvoyée à partir de l’appel designer.callExternalFunction. La chaîne est renvoyée sous forme de HGLOBAL contenant une chaîne de caractères larges.
L’exemple suivant de fonction dans une DLL affiche la chaîne transmise dans une boîte de dialogue et renvoie « Oui » ou « Non » en fonction de l’option choisie par l’utilisateur. La fonction C doit présenter le prototype de fonction comme dans l’exemple suivant.
extern "C" __declspec(dllexport) HGLOBAL _cdecl ShowMyDialog(HWND hwndParent, const wchar_t *pszArgument) {
int nResult = ::MessageBox(hwndParent, pszArgument, L"DLL Function Sample", MB_YESNO); // Allouer de la mémoire pour la chaîne obtenue
HGLOBAL hMem = GlobalAlloc(0, 64); if (!hMem)
return 0; wchar_t *pMem = (wchar_t *)GlobalLock(hMem);
wcscpy_s(pMem, 30, nResult == IDYES ? L"yes" : L"no"); ::GlobalUnlock(hMem); return hMem;
}
Syntaxe
designer.callExternalFunction ( STRING param1, STRING param2, STRING param3)
Paramètres
param1 Chaîne représentant le nom du fichier DLL. Spécifiez le nom du fichier racine de la DLL sans l’extension.
param2 Chaîne représentant le nom de la fonction.
param3 Paramètre de chaîne transmis à la fonction.
Renvoie
Chaîne.
676
Méthodes de script 5
5.2.3. getDialogString
677
Récupère les données issues de la boîte de dialogue Flex lancée par designer.showFlexDialog(). La boîte de dialogue Flex peut envoyer des données à Designer en appelant une interface externe :
ExternalInterface.call("setDialogString", "SomeVariableName", "VariableValue");
Si la boîte de dialogue Flex effectue cet appel externe vers Designer, une fois la boîte de dialogue fermée. « SomeVariableName » est disponible pour l’inspection du script de macro par le biais d’un appel de la méthode designer.getDialogString(). Dans cet exemple, l’appel serait designer.getDialogString("SomeVariableName") et la valeur renvoyée serait "VariableValue".
Syntaxe
designer.getDialogString ( STRING param )
Paramètres
param Chaîne valide représentant le nom de l’objet à inspecter. Ce champ est uniquement disponible pour l’inspection si l’application de formulaire générée avec Flex a effectué les appels ExternalInterface appropriés.
Renvoie
Chaîne valide représentant la valeur de la propriété sFieldName. Vide si l’application générée par Flex n’a pas défini cette valeur.
5.2.4. getLocale
Renvoie le jeu de paramètres régionaux actif dans Designer.
Syntaxe
designer.getLocal ()
Paramètres
Aucun.
Renvoie
Chaîne représentant le jeu de paramètres régionaux actif dans Designer, suivant le format fr_FR.
Méthodes de script
5.2.5. getSelection
Renvoie l’objet ou les objets actuellement sélectionnés dans l’éditeur de mise en forme ou dans la palette Hiérarchie. Si aucun objet n’est sélectionné, une liste vide est renvoyée.
Syntaxe
designer.getSelection ()
Paramètres
Aucun.
Renvoie
Renvoie une liste XFANodeList répertoriant les nœuds qui composent la sélection actuelle. Renvoie une liste vide en l’absence de toute sélection.
5.2.6. filterNodeTree
Filtre une arborescence de nœud suivant le type et le paramètre de filtre spécifié.
Syntaxe
designer.filterNodeTree (OBJECT param1, STRING param2, STRING param3)
Paramètres
param1 Expression syntaxique de référence représentant XFANodeTree.
param2 Chaîne représentant le type de filtre.
param3 Chaîne représentant le paramètre de filtre.
Filtres
className Nom de classe de l’objet souhaité.
678
Méthodes de script 5
679
name Nom de l’objet souhaité.
Renvoie
Renvoie la liste des nœuds qui correspondent.
5.2.7. println
Envoie le message sMsg au panneau Journal de la palette Rapport.
Syntaxe
designer.println( STRING param )
Paramètres
param Chaîne valide représentant le message rendu dans le panneau Journal.
Renvoie
Vide.
5.2.8. saveTextToFile
Enregistre du texte dans un fichier après avoir demandé à l’utilisateur de spécifier le dossier d’enregistrement. Le nom par défaut dans la boîte de dialogue Enregistrer sous est établi à partir de sDefaultFileName.
Syntaxe
designer.saveTextToFile (STRING param1, STRING param2 )
Paramètres
param1 Chaîne valide représentant les données de texte à enregistrer. Peut être vide.
Méthodes de script
param2 Chaîne valide représentant le nom de fichier par défaut indiqué dans la boîte de dialogue Enregistrer sous, que l’utilisateur doit valider. Peut être vide.
Renvoie
Renvoie la valeur TRUE si l’enregistrement réussit, FALSE dans le cas contraire.
5.2.9. setDialogString
Pousse des données dans la boîte de dialogue Flex avant d’appeler designer.showFlexDialog(). Pour que le script de macro puisse définir des données dans la boîte de dialogue Flex, il doit appeler designer.setDialogString() avec les données avant de lancer designer.showFlexDialog().
Syntaxe
designer.setDialogString ( STRING param1, STRING param2 )
Paramètres
param1 Chaîne valide représentant le nom de la variable que l’application générée avec Flex doit rechercher avec l’appel ExternalInterface.
param2 Chaîne valide représentant la valeur de la propriété sFieldName.
Renvoie
Vide.
680
Méthodes de script 5
5.2.10. showFlexDialog
681
Crée une boîte de dialogue modale, lance une instance du lecteur Flash dans la boîte de dialogue et charge le fichier SWF. Permet de fournir des interfaces utilisateur graphiques au sein de Designer.
REMARQUE : Placez le fichier SWF dans le dossier d’installation du script de macro. Le paramètre sSWF doit uniquement contenir un nom de fichier, mais aucune information sur le chemin d’accès. Designer charge uniquement le fichier SWF à partir du dossier dans lequel se trouve le fichier JavaScript en cours d’exécution.
Syntaxe
designer.showFlexDialog( STRING param1, INTEGER param2, INTEGER param3)
Paramètres
param1 Chaîne valide représentant le nom du fichier SWF à charger.
param2 Valeur entière valide représentant la largeur de l’interface utilisateur contenue dans le fichier SWF.Ce paramètre détermine la largeur de la boîte de dialogue hôte. Si ce paramètre prend une valeur inférieure à la largeur minimale de la boîte de dialogue, cette dernière est utilisée. Si ce paramètre prend une valeur supérieure à la largeur du Bureau définie pour la boîte de dialogue, cette dernière est utilisée.
param3 Valeur entière valide représentant la hauteur de l’interface utilisateur contenue dans le fichier SWF.Ce paramètre indique la hauteur de la boîte de dialogue hôte. Si ce paramètre prend une valeur inférieure à la largeur minimale de la boîte de dialogue, cette dernière est utilisée. Si ce paramètre prend une valeur supérieure à la hauteur du Bureau définie pour la boîte de dialogue, cette dernière est utilisée.
Renvoie
Chaîne issue de l’application de formulaire générée avec Flex. Lorsque l’application de formulaire générée avec Flex s’arrête, elle rappelle Designer pour lui indiquer qu’elle s’est arrêtée. Lors de ce rappel, elle transmet une chaîne. En général, l’application de formulaire générée avec Flex utilise cette méthode pour renvoyer son état de fermeture, par exemple OK ou Annuler.
Méthodes de script
5.2.11. showHelp
Ouvre une rubrique dans un fichier d’aide HTML Windows (CHM).
Syntaxe
designer.showHelp( STRING param1, STRING param2 )
Paramètres
param1 Valeur de chaîne valide représentant le nom du fichier (sans l’extension .chm) du fichier d’aide CHM. Ce fichier doit se trouver dans le même répertoire que le script de macro.
param2 (facultatif)
Valeur de chaîne valide représentant le nom de la rubrique à afficher. L’accès à la rubrique est déterminé par un chemin pouvant contenir des barres obliques vers l’avant.
Renvoie
Vide.
5.2.12. showTextWindow
Crée un fichier texte (scriptOutput.txt) dans le répertoire temporaire du système avec le contenu de sText, puis ouvre l’éditeur de texte par défaut du système avec ce fichier comme paramètre. Chaque invocation de cette méthode écrase le contenu du fichier temporaire. Plusieurs invocations ne permettent pas de concaténer le texte.
Cette méthode permet d’afficher un rendu de manière non modale. Les boîtes de dialogue Flex et Alerte sont toutes deux modales, ce qui empêche l’utilisateur d’interagir simultanément avec la sortie d’un script de macro et avec Designer. Dans certains cas, vous pouvez consulter la sortie afin d’apporter des modifications dans Designer.
Syntaxe
designer.showTextWindow( STRING param )
682
Méthodes de script 5
Paramètres
683
param1 Valeur de chaîne valide représentant le texte à afficher dans l’éditeur de texte par défaut du système.
Renvoie
Aucun renvoi.
5.2.13. showXDPinAcrobat
Prend le dataPacket fourni par vous et l’écrit dans un fichier XDP. Le fichier XDP référence le fichier PDF à charger et les données à fusionner et afficher. Cette méthode permet de créer des rapports enrichis à partir d’un script de macro.
Syntaxe
designer.showXDPinAcrobat( STRING param1, STRING param2)
Paramètres
param1 Valeur de chaîne valide représentant les données XML à écrire.
param2 Valeur de chaîne valide représentant le nom de base du fichier PDF à afficher, qui doit se trouver dans le même dossier que le script de macro.
Renvoie
Vide.
Comprendre le modèle d’objet de formulaire XML
6. Comprendre le modèle d’objet de formulaire XML
Un DOM est une interface de programmation neutre permettant aux programmes et scripts d’accéder et de mettre à jour dynamiquement le contenu, la structure et le style d’un document. Les DOM sont habituellement utilisés avec des données exprimées en XML.
Tous les DOM utilisés dans le modèle d’objet de formulaire XML partagent les mêmes caractéristiques :
• Ils ont une structure strictement arborescente.
• Un nœud peut avoir des enfants obligatoires. Dans de tels cas, les nœuds enfants obligatoires sont créés en même temps que leur parent.
• Les enfants non obligatoires de chaque nœud dans l’arborescence sont triés par âge. En d’autres termes, le DOM connaît l’ordre dans lequel les nœuds enfants non obligatoires ont été ajoutés.
Pour chaque étape du traitement du formulaire, il existe un DOM contenant les structures de données pour cette étape. Les scripts peuvent examiner et modifier chaque DOM. Les DOM sont chargés de maintenir la cohérence interne, mais non pas externe. Par exemple, lorsqu’un script active un bouton radio en attribuant le champ correspondant, tous les autres boutons couplés à celui-là sont automatiquement désactivés. Il s’agit de la cohérence interne, gérée par le DOM du formulaire lui-même.
En revanche, le DOM de données n’effectue aucune action pour empêcher un script de violer les règles de XML, par exemple en attribuant à un objet deux propriétés ayant le même nom. Il s’agit de la cohérence externe, responsabilité de l’auteur du script et non pas celle du DOM.
Le modèle d’objet de formulaire XML est utilisé chaque fois qu’une conception de formulaire est associée à des données, afin de faciliter le processus de fusion de modèle et de données pour créer le formulaire qui en résulte. Ce processus commence par utiliser les représentations de DOM XML existantes de la conception du formulaire et les données XML pour créer des modèles distincts. Ces modèles distincts stockent une représentation structurée de la conception du formulaire et les données XML originales. Le DOM du modèle correspond à la conception du formulaire, et le DOM des données aux données XML fournies par l’utilisateur.
Après la création du modèle et des modèles de données, un troisième modèle est créé, le DOM du formulaire, qui représente les informations fusionnées. Le DOM du formulaire sert à combiner les valeurs spécifiques des données XML avec les règles de présentation définies par la conception du formulaire.
684
Comprendre le modèle d’objet de formulaire XML 6
685
Après la création du DOM du formulaire, si vous créez un formulaire interactif, ce dernier est prêt à être déployé par les utilisateurs. Il est possible que les conceptions de formulaire interactives possèdent des données associées avec lesquelles elles sont fusionnées, mais la plupart des formulaires interactifs sont conçus pour prendre en charge des données saisies par l’utilisateur.
Le processus de création du DOM du formulaire est identique pour tous les formulaires. Les formulaires non interactifs disposent cependant d’un jeu de données devant être fusionné avec leur conception de formulaire. Dans le cas de formulaires ayant une mise en page fixe, la fusion de données ne détermine pas les règles de présentation du formulaire ; en d’autres termes, les données sont fusionnées dans les champs appropriés sans modifier les propriétés du champ. En revanche, lorsque des données sont fusionnées avec des formulaires ayant une mise en page souple, les champs augmentent ou diminuent pour prendre en compte la quantité des données fusionnées.
Le DOM du formulaire pour des formulaires disposant de mises en page fixes et souples est très similaire ; il s’agit d’un long formulaire sans pagination. Lorsque les données et les règles de présentations sont appliquées à ces types de formulaires, elles doivent être formatées selon les informations de mise en page. Un DOM de mise en page est créé à partir du DOM du formulaire qui structure le formulaire en pages et applique toutes les autres règles de page, telles la numérotation de pages, les caractères de début et les caractères de fin. Le diagramme suivant illustre ce processus.
Après l’application des règles de mise en page aux formulaires disposant d’une mise en page fixe ou souple, les deux types de formulaires sont terminés.
Comprendre le modèle d’objet de formulaire XML
6.1. DOM du modèle d’objet de formulaire XML
6.1.1. Modèle connectionSet
Le modèle connectionSet contrôle un schéma de données, ainsi qu’une source de données utilisée par un formulaire particulier. Ce modèle décrit les connexions au schéma XML, aux données du modèle XML et aux services Web. Le modèle connectionSet permet d’extraire les détails, comme une URL, d’un schéma référencé ou WSDL à des fins de rapports.
Le modèle connectionSet comprend les objets suivants :
LIENS CONNEXES :connectionSeteffectiveInputPolicyeffectiveOutputPolicyoperationrootElementsoapActionsoapAddressuriwsdlAddresswsdlConnectionxmlConnectionxsdConnection
686
Comprendre le modèle d’objet de formulaire XML 6
6.1.2. Modèle de données
687
Le modèle Data est une représentation en mémoire des données de l’utilisateur. Lorsqu’une conception de formulaire et des données sont fusionnées au moyen du processus de liaison de données, le modèle de données fournit le contenu des champs sur le formulaire final.
Grâce à ce modèle, il est possible d’accéder aux données et de les manipuler à partir d’une des sources de données suivantes :
• Document XML
• Base de données OLEDB
• Fichier de schéma XML
• Fichier WSDL
Le modèle Data comprend les objets suivants :
• dataGroup (désapprouvé)
• dataModel
• dataValue
• dataWindow
6.1.3. Modèle Event
Le modèle Event contrôle les modifications dans un formulaire qui se produisent avant, pendant et après les actions. Ces actions comprennent des événements de formulaire dynamique (stade auquel les données et la conception de formulaire sont fusionnées et avant la pagination), ainsi que des événements de formulaire interactif (moment auquel un utilisateur met à jour la valeur d’un champ).
Le modèle Event comprend les objets suivants :
• eventPseudoModel
Comprendre le modèle d’objet de formulaire XML
6.1.4. Modèle de formulaire
Le modèle Form est la représentation en mémoire des modèles Template et Data fusionnés. Grâce à ce modèle, il est possible de modifier l’apparence du formulaire, d’ajuster des valeurs de champ ou d’effectuer d’autres modifications avant de présenter le formulaire terminé à un utilisateur ou de traiter le formulaire dans le modèle Layout.
Les scripts sont exécutés par rapport au modèle Form par défaut ; par conséquent, vous n’avez pas besoin de préciser le modèle Form dans votre syntaxe de référence.
Le modèle Form comprend les objets suivants :
arcareaassistbarcodebindbindItemsbookendbooleanborderbreak (désapprouvé)breakAfterbreakBeforebuttoncalculatecaptioncertificatecertificatescheckButtonchoiceListcolorcombconnectcontentAreacornerdatedateTimedateTimeEditdecimal
defaultUi (désapprouvé)descdigestMethoddigestMethodsdrawedgedSigDataencodingencodingsencrypteventexclGroupexDataexecuteexObjectextrasfieldfillfilterfloatfontformformathandlerhyphenationimageimageEditinstanceManager
integerissuersitemskeepkeyUsagelinelinearmanifestmarginmdpmediummessagenumericEditoccuroidoidsoverflowpageAreapageSetparapasswordEditpatternpictureproto (désapprouvé)radialreasonreasonsrectangle
refscriptsetPropertysignaturesignatureProperties (désapprouvé)signDatasigningsolidspeakstipplesubformsubformSetsubjectDNsubjectDNssubmittemplatetexttextEdittimetimeStamptoolTiptraversaltraverseuivalidatevaluevariable
688
Comprendre le modèle d’objet de formulaire XML 6
6.1.5. Modèle Host
689
Le modèle Host fournir un ensemble de propriétés et de méthodes pour fonctionner au niveau de l’application. Ces propriétés et méthodes sont disponibles pour les scripts, indépendamment de l’application d’hébergement.
Le modèle Host comprend l’objet suivant :
• hostPseudoModel
6.1.6. Modèle Layout
Le modèle Layout est la représentation en mémoire d’un formulaire après sa fusion avec les données. Cette représentation est la mise en page finale du formulaire.
Le modèle Layout comprend l’objet suivant :
• layoutPseudoModel
6.1.7. Modèle de signature
Le modèle Signature fournit un ensemble de méthodes pour fonctionner avec les signatures numé-riques XML conformes à la norme de signature W3C XML(http://www.w3.org/TR/xmldsig-core/). Vous pouvez y indiquer des commandes de script pour signer, effacer, énumérer et vérifier des signatures.
Le modèle Signature comprend l’objet suivant :
LIENS CONNEXES :signaturePseudoModel
6.1.8. Modèle sourceSet
Le modèle sourceSet fournit une connexion entre une base de données OLEBD externe et le modèle Data. Ce modèle permet de contrôler les connexions à la source de données et de fusionner des enregistrements au sein de la source de données.
Le modèle sourceSet comprend les objets suivants :
• bind
• boolean
• command
• connect
• connectString
Comprendre le modèle d’objet de formulaire XML
• delete
• extras
• insert
• integer
• map
• password
• query
• recordSet
• select
• source
• sourceSet
• text
• update
• user
6.1.9. Modèle XFA
Le modèle XFA définit le modèle d’application que Designer utilise pour implémenter le modèle d’objet de formulaire XML. Le modèle d’application est le modèle de base à partir duquel tous les autres modèles sont dérivés.
Le modèle XFA comprend les objets suivants :
packet
xfa
690
Exemples de JavaScript 7
7. Exemples de JavaScript
691
Ces exemples illustrent les propriétés et les méthodes prises en charge dans l’environnement de ces scripts.
7.1. Référence aux objets
Ces exemples illustrent plusieurs moyens de référencer un objet.
Lors de l’accès à une instance spécifique d’un objet, tenez compte du nombre d’occurrence de l’objet à l’endroit où se trouve le script. Le script renverra l’objet avec le même nombre d’occurrence en tant qu’objet à l’endroit où se trouve le script. Voici par exemple trois boutons ayant le même nom (Button1[0], Button1[1] et Button1[2]) et trois champs de texte ayant le même nom (TF1[0], TF1[1] et TF1[2]). Si le script sur Button1[2] est xfa.host.messageBox(TF1.rawValue)le résultat sera TF1[2].rawValue, et non TF1[0].rawValue.
7.1.1. Utilisations
Propriétés Méthodes
accessindexlayoutlengthnamenewTextnumPagesoneOfChildparentprevTextrawValuetargetthis
itemresolveNoderesolveNodespageContentpageCount
Exemples de JavaScript
7.1.2. Scripts
7.1.3. Accès à la première instance d’un champ de texte
// Accéder à un champ de parent immédiat à l’aide d’un nom de champ. // Accéder à la première instance de TextField1. TextField1.rawValue = "Hello";
7.1.4. Accès à la première instance d’un champ de texte
// Accéder à la première instance de TextField1. Lors de la création de scripts avec JavaScript, utilisez // xfa.resolveNode pour commencer la recherche en haut et progresser vers le bas de la hiérarchie // du formulaire. xfa.resolveNode("TextField1").rawValue = "Hello"; xfa.resolveNode("TextField1[0]").rawValue = "Hello";
7.1.5. Accès à un champ avec des accesseurs
// Lors de la création de scripts avec le langage JavaScript, utilisez la méthode resolveNode() pour accéder à un champ // avec une expression SOM contenant un opérateur # ou []. Lors de la recherche // à l’aide de la méthode this.resolveNode, la recherche commence à partir de l’objet actif et remonte // la hiérarchie du formulaire. this.resolveNode("Subform2[1].NumericField4").rawValue = 25;
7.1.6. Accès à un sous-formulaire avec un numéro d’index
// Accéder à un sous-formulaire avec un numéro d’index. Lors de l’utilisation de xfa.resolveNode, la recherche commence // en haut de la hiérarchie du formulaire et progresse vers le bas. var nIndex = 2; var sSOM = "Subform2[" + nIndex + "]"; var oSubform = xfa.resolveNode(sSOM); oSubform.NumericField4.rawValue = "25";
692
Exemples de JavaScript 7
7.1.7. Accès à une propriété de champ
693
// Accédez à une propriété de champ à l’aide d’un nom et d’une valeur de propriété. // Modifiez les propriétés de champ d’un sous-formulaire spécifique. // Utilisez l’opérateur [] pour accéder à la propriété d’un objet. var sProperty = "access"; var sValue = "readOnly";
// Tout d’abord, obtenez les nœuds de sous-formulaire. var oNodes = Subform2.nodes; var nNodesLength = oNodes.length; // Effectuer une boucle à travers les nœuds du sous-formulaire pour rechercher les champs. for (var nNodeCount = 0; nNodeCount < nNodesLength; nNodeCount ++) { // Définir la propriété de champ. if (oNodes.item(nNodeCount).className == "field") { oNodes.item(nNodeCount)[sProperty] = sValue; } }
7.1.8. Dénombrement des champs de texte dans un document
// Dénombrer le nombre de champs de texte d’un document. // Obtenir les conteneurs de champ de chaque page. for (var nPageCount = 0; nPageCount < xfa.host.numPages; nPageCount++) {
var oFields = xfa.layout.pageContent(nPageCount, "field"); var nNodesLength = oFields.length; var nCount = 0;
for (var nNodeCount = 0; nNodeCount < nNodesLength; nNodeCount++) { if (oFields.item(nNodeCount).ui.oneOfChild.className == "textEdit") { nCount++; } } TextField1.rawValue = nCount; }
Exemples de JavaScript
7.1.9. Accès à des champs au moyen de noms partiels d’objet
// Accéder aux champs à l’aide de noms d’objet partiels. // Obtenir les conteneurs de champ de chaque page. for (var nPageCount = 0; nPageCount < xfa.host.numPages; nPageCount++) {
var oFields = xfa.layout.pageContent(nPageCount, "field"); var nNodesLength = oFields.length;
for (var nNodeCount = 0; nNodeCount < nNodesLength; nNodeCount++) { if (oFields.item(nNodeCount).name.substr(0,2) == "Te") { xfa.host.messageBox(oFields.item(nNodeCount).name); } } }
7.1.10. Accès à une liste d’options de valeur
// Utiliser la propriété newText ou prevText pour accéder à la valeur de liste des choix avant // ou après la modification de la valeur. // Déclencher le script lors d’un événement de modification. TextField1.rawValue = xfa.event.prevText; TextField2.rawValue = xfa.event.newText;
7.1.11. Accès à un champ dans un sous-formulaire
// Accéder à un champ imbriqué à l’intérieur d’un sous-formulaire de parent immédiat en ajoutant au nom de champ // son nom de parent sous forme de préfixe. Subform2.TextField3.rawValue = "Hello";
7.1.12. Accès à des champs dans un sous-formulaire
// Accéder aux champs de premier niveau imbriqué à l’intérieur d’un sous-formulaire. Subform1.resoveNodes("#field[*]")
694
Exemples de JavaScript 7
7.1.13. Obtention des champs à partir de chaque page
695
// Obtenir des conteneurs de champ de chaque page. for (var i = 0; i < xfa.host.numPages; i++) {
var oFields = xfa.layout.pageContent(i, "field"); var nodesLength = oFields.length;
// Définir le type d’accès. for (var j = 0; j < nodesLength; j++) {
var oItem = oFields.item(j);
if (oItem != this) {
oItem.access = "readOnly"; } } }
7.1.14. Création d’un nœud dans le modèle de données
Cet exemple illustre la façon de créer ou cloner un nouveau nœud de modèle de données.
Utilisations
Propriétés Méthodes
lengthnodesrawValuevalue
appendclonecreateNodemessageBoxrecordremoveresolveNode
Exemples de JavaScript
Script
Création d’un nœud de données
// Afficher le nombre de nœؔuds enfant sous rootNode (xfa.record). // rootNode est le nœud racine du fichier de données. xfa.host.messageBox("Initial number of nodes under rootNode: " + xfa.record.nodes.length); // Créer un nœud de type dataGroup. var oGroupNode = xfa.datasets.createNode("dataGroup", "NewGroupNode");
// Ajouter le nœud de groupe de données au nœud de modèle de données existant. xfa.record.nodes.append(oGroupNode);
// Afficher le nombre de nœؔuds enfant sous rootNode. xfa.host.messageBox("Number of nodes under rootNode after first append: " + xfa.record.nodes.length);
// Créer un nœud de type dataValue. var oValueNode = xfa.datasets.createNode("dataValue", "NewValueNode");
// Définir la valeur du nouveau nœud de valeur de données. oValueNode.value = "The item value";
// Ajouter le nœud de valeur de données au groupe de données créé ci-dessus. xfa.record.NewGroupNode.nodes.append(oValueNode);
// Obtenir la valeur du modèle de données. TextField1.rawValue = xfa.record.NewGroupNode.NewValueNode.value;
// Ajouter un nœud de groupe de données cloné. xfa.record.nodes.append(xfa.record.NewGroupNode.clone(1));
// Afficher le nombre de nœuds enfant sous rootNode. xfa.host.messageBox("Number of nodes under rootNode after appending clone: " + xfa.record.nodes.length);
// Définir la valeur du nouveau nœud de valeur de données. xfa.resolveNode("xfa.record.NewGroupNode[1].NewValueNode").value = "The clone value";
// Obtenir la valeur du nœud de valeur de données cloné. TextField2.rawValue = xfa.resolveNode("xfa.record.NewGroupNode[1].NewValueNode").value;
// Supprimer le groupe de données cloné de la liste de nœud. var oRemoveNode = xfa.resolveNode("xfa.record.NewGroupNode[1]"); xfa.record.nodes.remove(oRemoveNode);
// Afficher le nombre de nœuds enfant sous rootNode. xfa.host.messageBox("Number of nodes under rootNode once clone node removed: " + xfa.record.nodes.length);
696
Exemples de JavaScript 7
7.1.15. Manipulation des instances d’un sous-formulaire
697
Ces exemples illustrent plusieurs façons d’ajouter ou de supprimer des instances d’un sous-formulaire au moment de l’exécution.
Utilisez le gestionnaire d’instances pour manipuler les pages d’un formulaire avec une mise en page fixe. Chaque page est un sous-formulaire ; par conséquent, ajouter ou supprimer un sous-formulaire équivaut à ajouter ou supprimer une page. Au moment de l’exécution, vous ne pouvez pas modifier la mise en page d’un formulaire si la mise en page est fixe. Vous pouvez ajouter et supprimer des instances à l’événement form:ready ; cependant, si le script est sur un événement en exécution, comme click, il ne se passera rien.
Utilisations
Propriétés Méthodes
minindexparentvalue
addInstancemoveInstanceremoveInstanceresolveNodesetInstances
Scripts
Ajout d’une instance en appelant le gestionnaire d’instances
// Ajouter une instance d’un sous-formulaire à l’aide de la syntaxe de trait de soulignement pour appeler le // gestionnaire d’instances directement. // Les formulaires rendus dans un navigateur web ne prennent pas en charge la syntaxe de trait de soulignement. // Cependant, la syntaxe de trait de soulignement est prise en charge si le script est exécuté sur le // serveur. _Subform2.addInstance(1);
Ajout d’une instance en appelant la propriété instanceManager
// Ajouter une instance en appelant la propriété instanceManager Prenez // soin de vous assurer que l’ajout d’un sous-formulaire ne violera pas la valeur maximum // possible. Subform2.instanceManager.addInstance(1);
Exemples de JavaScript
Suppression d’une instance
// Supprimer une instance d’un sous-formulaire. Définissez la valeur occur minimum uniquement si la suppression d’une instance // la violerait. Par exemple, définissez la valeur occur minimum sur 0 si vous souhaitez // supprimer la dernière, ou la seule, instance d’un sous-formulaire. // Les formulaires rendus dans un navigateur web ne prennent pas en charge la syntaxe de trait de soulignement. // Cependant, la syntaxe de trait de soulignement est prise en charge si le script est exécuté sur le // serveur. Subform2.occur.min = "0"; _Subform2.removeInstance(0);
Suppression du sous-formulaire parent
// Supprimez le sous-formulaire parent. parent.occur.min = "0"; parent.instanceManager.removeInstance(parent.index);
Définition du nombre d’instances
// Définir le nombre d’instances d’un sous-formulaire. var oSubform = xfa.resolveNode("Subform2"); oSubform.instanceManager.setInstances(5);
Insertion d’une nouvelle instance de sous-formulaire
// Insérer une nouvelle instance de sous-formulaire. Ce script ne fonctionne pas avec un formulaire statique. // Le script est appelé par un bouton, appelé Insérer un sous-formulaire, qui est imbriqué // à l’intérieur d’un sous-formulaire répétitif. Le nouveau sous-formulaire est inséré sous le sous-formulaire // actuel. var oSubform = this.resolveNode("Subform2"); var oNewInstance = oSubform.instanceManager.addInstance(1); var nIndexFrom = oNewInstance.index; var nIndexTo = this.parent.index + 1; // Appeler instanceManager pour insérer le sous-formulaire au-dessous du sous-formulaire actuel. oSubform.instanceManager.moveInstance(nIndexFrom, nIndexTo);
698
Exemples de JavaScript 7
Ajout et suppression d’un sous-formulaire
699
// Appeler le gestionnaire d’instances afin d’ajouter et de supprimer le sous-formulaire de commentaires. if (fComments.value == "0") { // Dans cet exemple, fComments est une variable de document utilisée en tant qu’indicateur. // La variable fComments est égale à 1 lorsque le sous-formulaire de commentaires est affiché. _comments.setInstance(1); // Ajouter le sous-formulaire de commentaires. Changez la légende du bouton. this.resolveNode("caption.value.#text").value = "Clear Comments"; // Définir la valeur de l’indicateur. fComments.value = "1"; } else { // Supprimer le sous-formulaire de commentaires. _comments.setInstance(0); // Changer la légende du bouton. this.resolveNode("caption.value.#text").value = "Add Comments"; // Redéfinir la valeur de l’indicateur. fComments.value = "0"; }
7.1.16. Obtention ou définition des valeurs d’objet
Ces exemples illustrent plusieurs façons d’obtenir ou de définir une valeur pour un objet.
Utilisations
Propriétés
formattedValuerawValuevalue
Scripts
Utilisation de rawValue
// Utilisez la propriété rawValue pour définir et obtenir la valeur brute d’un champ. TextField1.rawValue = "K1V1W3"; // Définir la valeur brute du champ. TextField2.rawValue = TextField1.rawValue // Obtenir la valeur brute du champ.
Exemples de JavaScript
Utilisation des valeurs
// Utiliser la propriété value pour définir et obtenir la valeur brute d’un champ. TextField1.rawValue = "k1V1W3"; TextField2.rawValue = TextField1.value.oneOfChild.value
Utilisation de formattedValue
// Utiliser la propriété formattedValue pour définir et obtenir la valeur formatée du champ. // Utilisez la propriété value pour définir et obtenir la valeur d’un objet (image). TextField1.rawValue = "K1V1W3"; // Définir la valeur brute du champ. TextField1.format.picture.value = "A9A 9A9"; // Définir le format d’image d’affichage du champ. TextField2.rawValue = TextField1.formattedValue; // Obtenir la valeur formatée du champ.
Définition d’une valeur d’objet de données
// Utiliser la propriété value pour définir et obtenir la valeur d’un objet de données. // Dans ce script, groupNode est un groupe de données et addressL1 est une valeur de données dans // le fichier de données. TextField1.rawValue = xfa.record.groupNode.address.line1.value;
Définition de la valeur de la variable de document
// Utiliser la propriété value pour définir et obtenir la valeur de la variable de document. TextField1.rawValue = docVar.value;
7.1.17. Utilisation de la numérotation des pages et du nombre de pages
Ces exemples illustrent plusieurs façons de recourir aux modèles d’hôte et de mise en page pour utiliser la numérotation des pages et le nombre de pages.
Les modèles d’hôte et de mise en page ont différentes propriétés et méthodes pour utiliser la numé-rotation des pages et le nombre de pages. Les propriétés de l’hôte et les méthodes que vous devez utiliser dépendent de la fonction du script et du moment de son exécution.
De nombreuses propriétés et méthodes de l’hôte ne sont pas disponibles sur le serveur. Utilisez les propriétés et les méthodes de l’hôte pour définir ou obtenir des numéros de page au moment de l’exécution.
Aucune des méthodes de mise en page définit le numéro de page. Utilisez les méthodes de mise en page pour obtenir la page en cours à layout:ready ou pour afficher les numéros de pages en bas de page et voir le nombre de pages lors de l’ouverture d’un formulaire sur un client.
700
Exemples de JavaScript 7
Utilisations
701
Propriétés Méthodes
currentPagelayoutnumPagesrawValuethis
absPageabsPageCountpagepageCountpageDownpageUp
Scripts
Obtention du numéro de page
// Utiliser les méthodes de mise en page pour obtenir le nombre de pages actuel. TextField1.rawValue = xfa.layout.page(this); // Basé sur 1. TextField2.rawValue = xfa.layout.absPage(this); // Basé sur 0.
Obtention du numéro de page à l’aide de la méthode pageCount
// Utiliser les méthodes pageCount de mise en page pour obtenir le nombre de pages d’un document. TextField1.rawValue = xfa.layout.pageCount(); // Obtenir le nombre logique de pages. TextField2.rawValue = xfa.layout.absPageCount(); // Obtenir le nombre physique de pages.
Formatage de la pagination
// Utiliser les méthodes layout page et pageCount pour effectuer la mise en page. TextField1.rawValue = "Page " + xfa.layout.page(this) + " of " + xfa.layout.pageCount();
Obtention et définition du numéro de la page en cours
// Utiliser la propriété host currentPage pour obtenir et définir le nombre actuel de pages à // l’exécution. // Ce script ne peut pas être utilisé lors d’un événement layout:ready, form:ready ou // initialize. Cependant, il fonctionne si le script est placé sur un bouton. xfa.host.currentPage = 1; // Aller à la page 2 (basé sur 0).
Exemples de JavaScript
Obtention du numéro de page à l’aide de la propriété pageCount
// Utiliser la propriété host numPages pour obtenir le nombre de pages d’un document. TextField1.rawValue = xfa.host.numPages; // Obtenir le nombre de pages.
Accès à la fin d’un document
// Utiliser la méthode pageDown() pour parcourir un document. xfa.host.pageDown(); // Aller à la page suivante.
Accès au début d’un document
// Utiliser la méthode host pageUp() pour parcourir un document. xfa.host.pageUp(); // Aller à la page précédente.
7.1.18. Concaténation de valeurs de données
Cet exemple explique comment concaténer des valeurs de données dans un bloc d’adresses et s’assurer qu’il n’y a aucune ligne vide.
Utilisations
Propriétés Méthodes
multiLineoneOfChildrawValuevalue
record
702
Exemples de JavaScript 7
Script
Concaténation de valeurs de données
703
// Obtenir les valeurs du modèle de données. var sName = xfa.record.groupNode.address.line1.value; var sPostbox = xfa.record.groupNode.address.line2.value; var sStreet = xfa.record.groupNode.address.line3.value; var sCity = xfa.record.groupNode.address.line4.value; var sRegion = xfa.record.groupNode.address.line5.value; var sCountry = xfa.record.groupNode.address.line6.value; var sPostcode = xfa.record.groupNode.address.line7.value; var addressArray = new Array(sName,sPostbox,sStreet,sCity,sRegion,sCountry,sPostcode);
var sAddressBlock = "";
// Ne pas afficher la boîte aux lettres si la valeur n’est pas fournie. if (addressArray[1] == null) { sAddressBlock = addressArray[0] + "\n" + addressArray[2] + "\n" + addressArray[3] + "\n"; } else { sAddressBlock = addressArray[0] + "\n" + addressArray[1] + "\n" + addressArray[3] + "\n"; }
// Ne pas afficher la région si la valeur n’est pas fournie. if (addressArray[4] == null) { sAddressBlock = sAddressBlock + addressArray[5] + " " + addressArray[6]; } else { sAddressBlock = sAddressBlock + addressArray[4] + ", " + addressArray[5] + " " + addressArray[6]; } TextField2.rawValue = sAddressBlock; // S’assurer que le champ est configuré afin d’afficher une valeur de ligne multiple. Pour définir la // propriété multiLine par programmes, ajoutez la ligne suivante : TextField2.ui.oneOfChild.multiLine = "1";
Exemples de JavaScript
7.1.19. Calcul de totaux
Cet exemple explique comment calculer des totaux.
Utilisations
Propriétés Méthodes
lengthrawValue
resolveNodes
Script
Calcul de totaux
// Accéder à un champ dans un sous-formulaire répétitif en effectuant une boucle dans la liste de nœuds. var oFields = xfa.resolveNodes("Subform2[*].NumericField4"); var nNodesLength = oFields.length; var nSum = 0; for (var nNodeCount = 0; nNodeCount < nNodesLength; nNodeCount++) { nSum += oFields.item(nNodeCount).rawValue; } TextField1.rawValue = nSum;
7.1.20. Modification de la couleur d’arrière-plan
Ces exemples illustrent comment modifier la couleur d’arrière-plan d’un sous-formulaire ou de champs.
Dans un formulaire avec une disposition souple, vous pouvez modifier, au moment de l’exécution, la couleur d’arrière-plan de tout le champ, y compris la légende et la zone de champ. Par contre, dans un formulaire avec une mise en page fixe, vous ne pouvez modifier que la couleur d’arrière plan de la zone de champ au moment de l’exécution.
704
Exemples de JavaScript 7
Utilisations
705
Propriétés Méthodes
fillColorindexlengthnamenodesparentvaluethis
itemresetDataresolveNoderesolveNodes
Scripts
Modification de la couleur d’arrière-plan d’un sous-formulaire
// Modifier la couleur d’arrière-plan d’un sous-formulaire répétitif. var oNodes = xfa.resolveNodes("Subform2[*]"); var nNodesLength = oNodes.length;
for (var nNodeCount = 0; nNodeCount < nNodesLength; nNodeCount++) { if (oNodes.item(nNodeCount).index%2 != 0) { oNodes.item(nNodeCount).border.fill.color.value = "200,200,250"; } else { oNodes.item(nNodeCount).border.fill.color.value = "200,150,250"; } }
Modification de la couleur d’arrière-plan d’un champ
// Modifier la couleur d’arrière-plan du champ NumericField4. // Avant d’exécuter ce script, définir une couleur d’arrière-plan ou définir la propriété // border.fill.presence afin qu’elle soit visible. var oNodes = xfa.resolveNodes("Subform2[*]"); var nNodesLength = oNodes.length; var sFillColor; for (var nNodeCount = 0; nNodeCount < nNodesLength; nNodeCount++) {
if (oNodes.item(nNodeCount).index%2 != 0) { sFillColor = "200,200,250";
} else { sFillColor = "200,150,250";
} oNodes.item(nNodeCount).NumericField4.fillColor = sFillColor; }
Exemples de JavaScript
Modification de la couleur d’arrière-plan des lignes d’un sous-formulaire
// Réinitialiser les champs du sous-formulaire actif. var dString = "xfa.form.form1.dtls[" + this.parent.index + "]"; var oDetails = xfa.form.resolveNode(dString); var sDtlFields;
// Générer la chaîne des noms de champ à réinitialiser. for (var i = 0; i < oDetails.nodes.length; i++) { sDtlFields = sDtlFields + "," + dString + "." + oDetails.nodes.item(i).name; } // Transmettre la variable de chaîne en tant que paramètre. xfa.host.resetData(sDtlFields); OR // // Modifier la couleur d’arrière-plan des rangées répétées. if (this.index%2 != 0) this.border.fill.color.value = "255,255,255"; else this.border.fill.color.value = "201,201,146";
7.1.21. Remplissage d’une liste déroulante
Ces exemples illustrent plusieurs moyens d’ajouter ou de supprimer des éléments de liste dans une liste déroulante.
Avant de remplir une liste déroulante au moment de l’exécution, enregistrez la liste d’éléments. Dans le cas contraire, vous risquez de perdre les éléments. Seule la valeur est enregistrée dans les données.
Utilisations
Propriétés Méthodes
lengthnewTextnodesprevTextrawValuevalue
addItemclearItemsitemmessageBoxrecordresolveNode
706
Exemples de JavaScript 7
Scripts
Remplissage d’une liste déroulante à partir d’un service Web
707
// Remplir la liste déroulante avec des valeurs d’un service web. // Le service web utilisé dans cet exemple est factice. SOAP.wireDump = false; var oListURL = "http://www.webser-vice.net/wsdl/query.wsdl"; var e; try { xfa.host.messageBox("Starting list retrieval.");
var service = SOAP.connect(oListURL);
if(typeof service != "object") { xfa.host.messageBox("Couldn't get List object."); } if(service.getAllServiceNames == "undefined") { xfa.host.messageBox("Couldn't get getAllServiceNames Call."); }
// Démarrer la requête var oItems = service.getAllServiceNames(); if(oItems == null) { xfa.host.messageBox("List empty."); } var nCount = 0; var nLimit = 10;
for(var nItemCount in oItems) { for(var nItemNode in oItems[nItemCount]) { if (nItemNode == "name") DropDownList1.addItem(oItems[nItemCount][nItemNode]); } if (++nCount >= nLimit) break; } } catch(e) { xfa.host.messageBox("Problem with list Call: " + e); }
Effacement d’une liste déroulante
// Effacer les éléments dans une liste déroulante. DropDownList1.clearItems();
Exemples de JavaScript
Remplissage d’une liste déroulante à partir d’un fichier de données
// Remplir la liste déroulante avec des valeurs issues d’un fichier de données. var oItems = xfa.resolveNode("xfa.record.groupNode.list"); var nItemsLength = oItems.nodes.length;
for (var nItemCount = 0; nItemCount < nItemsLength; nItemCount++) { DropDownList1.addItem(oItems.nodes.item(nItemCount).value); } DropDownList1.rawValue = "Second item in list";
Enregistrement de valeurs d’une liste déroulante dans un autre champ
// Accéder aux éléments dans une zone de liste déroulante et enregistrer leurs valeurs dans un champ // distinct. var oItems = xfa.resolveNode("DropDownList1.#items"); var nItemsLength = oItems.nodes.length;
for (nItemCount = 0; nItemCount < nItemsLength; nItemCount++){
if (TextField2.rawValue == null) { TextField2.rawValue = oItems.nodes.item(nItemCount).value; } else { TextField2.rawValue = TextField2.rawValue + "\n" + oItems.nodes.item(nItemCount).value; } }
Accès à une valeur de liste déroulante à l’aide de la propriété newText ou prevText
// Utiliser les propriétés newText ou prevText pour accéder à une valeur de liste déroulante // avant ou après la modification de la valeur. // Exécuter le script lors d’un événement de modification. TextField1.rawValue = xfa.event.prevText; TextField2.rawValue = xfa.event.newText;
7.1.22. Enregistrement d’un formulaire
Ces exemples illustrent comment exporter des données d’un formulaire et enregistrer un formulaire.
Utilisations
Propriétés Méthodes
target exportData
708
Exemples de JavaScript 7
Scripts
Exportation de données de formulaire sans indication d’un nom de fichier
709
// Exporter des données d’un formulaire sans indiquer un nom de fichier. L’utilisateur final est // invité à fournir le nom de fichier. xfa.host.exportData(); // Génère des données au format XDP. xfa.host.exportData("", 0); // Génère des données au format XML.
Exportation de données de formulaire à l’aide d’un nom de fichier
// Si vous spécifiez un nom de fichier, le script doit être exécuté sur un formulaire certifié. xfa.host.exportData("filename.xdp"); // Génère des données au format XDP. xfa.host.exportData("filename.xml", 0); // Génère des données au format XML.
Enregistrement d’un formulaire
// L’enregistrement du formulaire étant effectué au niveau de l’application, vous devez appeler le modèle d’application // Acrobat. App.executeMenuItem("SaveAs"); // L’utilisateur final sera invité à spécifier un // nom de fichier. // Cependant, vous devez enregistrer le formulaire silencieusement si le formulaire doit être certifié // et le certificat doit être approuvé pour le langage Javascript privilégié. var mydoc = event.target; mydoc.saveAs();
7.1.23. Rendre un objet visible ou invisible
Cet exemple illustre comment rendre un objet visible ou invisible. Un bouton Imprimer invisible empêche l’utilisateur d’imprimer un document.
L’événement prePrint est déclenché immédiatement avant la sortie du formulaire pour impression. De même, l’événement postPrint est déclenché immédiatement après l’impression du formulaire.
Utilisations
Propriétés
presencerelevant
Exemples de JavaScript
Scripts
Définition d’un champ à rendre visible ou invisible
// Si un champ est visible, le rend invisible et vice versa. if(Field1.presence == "visible") { Field1.presence = "invisible"; } else { Field1.presence = "visible"; }
Définition d’un bouton à rendre visible mais non imprimable
// Définir un bouton afin de le rendre visible mais non imprimable au moment de la conception. Button1.relevant="-print"
7.1.24. Utilisation des cases d’option et des cases à cocher
Ces exemples illustrent comment sélectionner et supprimer des boutons radio et des cases à cocher.
Utilisations
Propriétés Méthodes
rawValue messageBoxresolveNodes
Scripts
Sélection d’un bouton radio
// Sélectionner le premier bouton radio. RadioButtonList.rawValue = '1'; xfa.host.messageBox('Value of RadioButtonList: ' + RadioButtonList.rawValue);
// Sélectionner le second bouton radio. RadioButtonList.rawValue = '2'; xfa.host.messageBox('Value of RadioButtonList: ' + RadioButtonList.rawValue);
710
Exemples de JavaScript 7
Accès à des boutons radio
711
// Accéder aux boutons radio. RadioButtonList.resolveNodes("#field[*]")
Suppression d’un bouton radio
// Effacer une valeur RadioButtonList. Toute valeur non valide efface la liste. RadioButtonList.rawValue = '3'; xfa.host.messageBox('Value of RadioButtonList: ' + RadioButtonList.rawValue);
Sélection d’une case à cocher
// Sélectionner une case à cocher. CheckBox1.rawValue = 1; xfa.host.messageBox('Value of checkbox: ' + CheckBox1.rawValue);
Désélection d’une case à cocher
// Désélectionner une case à cocher. CheckBox1.rawValue = 0; xfa.host.messageBox('Value of checkbox: ' + CheckBox1.rawValue);
7.1.25. Détermination de la modification d’un formulaire
Cet exemple illustre comment déterminer la modification d’un formulaire.
Utilisations
Propriétés Méthodes
rawValue messageBoxsaveXML
Exemples de JavaScript
Script
Détermination de la modification d’un formulaire
// Enregistrer une copie du fichier XML d’origine. var sOriginalXML = xfa.data.saveXML();
// Changer les données du formulaire. TextField1.rawValue = "changed";
// Déterminer si les données du formulaire ont été modifiées. if(sOriginalXML == xfa.data.saveXML()) { xfa.host.messageBox("Form has not changed."); } else { xfa.host.messageBox("Form has changed."); }
7.1.26. Désactivation de tous les champs d’un formulaire
Cet exemple illustre comment désactiver tous les champs sur un formulaire.
Utilisations
Propriétés Méthodes
accesslayoutlengthnumPages
itempageContentpageCount
Script
Désactivation de tous les champs d’un formulaire
// Obtenir des conteneurs de champ de chaque page. for (var nPageCount = 0; nPageCount < xfa.host.numPages; nPageCount++) { var oFields = xfa.layout.pageContent(nPageCount, "field"); var nNodesLength = oFields.length;
// Définir la propriété de champ. for (var nNodeCount = 0; nNodeCount < nNodesLength; nNodeCount++) { oFields.item(nNodeCount).access = "readOnly"; } }
712