Guide de référence des scripts de Designer - helpx.adobe.com · A propos du guide de référence...

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.

http://www.adobe.com/go/learn_aemforms_scriptingBasics_62

http://www.adobe.com/go/learn_aemforms_scriptingBasics_62

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.



object, classe liste Aucun

2.2.2. Propriété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


2.3. treeList, classe

5

La classe treeList représente une liste de nœuds d’arborescence.



liste treeList Aucun

2.3.2. Propriétés

Aucun

2.3.3. Méthodes


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.



object, classe tree Aucun


2.4.2. Propriété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


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


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.


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


2.5.2. Propriété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


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


2.6. container, classe

9

La classe container fournit des objets de conteneur aux modèles de formulaire.



node class container areacontentAreadrawfieldpageAreapageSetsubformsubformSetvariable

2.6.2. Propriétés

Aucun

2.6.3. Méthodes


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


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.



node class content booleandatedateTimedecimalexDatafloatintegertexttime

2.7.2. Propriétés

Aucun

2.7.3. Méthodes

Aucun

10


2.8. model, classe

11

La classe model constitue la classe de base pour les objets racine de chaque modèle.



node class model connectionSetdataModelformtemplatesourceSetxfa

2.8.2. Propriété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


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


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.



node class textNode certificateconnectStringdeletehandlerinsertoidoperationpasswordreasonref

rootElementselectsoapActionsoapAddressspeaktoolTipupdateuriuserwsdlAddress

2.9.2. Propriété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


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


3.1.4. Méthodes

Aucun

3.2. area

L’objet area représente le regroupement d’autres objets de conteneur sur un formulaire.



Modèle de formulaire descextras


container, classe

14

Objets de script 3

3.2.3. Propriétés

15


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.


relevant Contrôle si un objet de formulaire est inclus dans l’opération d’impression. 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.


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.


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.



Modèle de formulaire speaktoolTip

Objets de script



3.3.3. Propriétés


role Indique le rôle joué par le conteneur parent. 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


17


Modèle de formulaire extras



3.4.3. Propriétés


charEncoding Spécifie le codage de caractères de la valeur codée dans un code à barres.


checksum Indique un algorithme de la somme de contrôle à insérer dans un code à barres.


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).


dataLength Indique le nombre maximal de caractères de cette instance du code à barres. Cette propriété s’applique uniquement aux codes à barres unidimensionnels.


dataPrep Définit le prétraitement appliqué aux données consignées dans le code à barres.


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).


endChar Indique un caractère de commande de fin facultatif à ajouter aux données du code à barres.


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).


Objets de script

moduleHeight Détermine la hauteur d’une série de barres utilisées pour coder un caractère de texte fourni.


moduleWidth Spécifie différents aspects d’un code à barres en fonction de la classe de codes à barres utilisée.


printCheckDigit Spécifie si les chiffres de contrôle doivent être imprimés dans le texte affichable.


rowColumnRatio

Un rapport facultatif rangées/colonnes pour les codes à barres 2D pris en charge.


startChar Indique le caractère de commande de départ facultatif à ajouter au début des données du code à barres.


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



wideNarrowRatio

Spécifie un rapport barre large/barre étroite dans les codes à barres pris en charge.



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.



Modèle de formulaireModèle sourceSet

picture



3.5.3. Propriétés


contentType Spécifie le type de contenu présent dans le document référencé, à savoir MIME.


match Contrôle le rôle de l’objet encadré lors d’une opération de liaison de données (fusion).


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é.


transferEncoding Indique le codage du contenu binaire dans le document référencé. 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.



Modèle de formulaire ref



3.6.3. Propriétés


connection Spécifie le nom du contrôle de connexion associé dans l’ensemble de connexions.


labelRef Résout une valeur de données pour chaque nœud de données dans le jeu identifié par l’objet ref.


valueRef Résout une valeur de données pour chaque nœud de données dans le jeu identifié par l’objet ref.


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.



Modèle de formulaire none



3.7.3. Propriétés


leader Indique l’objet subform ou subformSet devant être placé en haut d’une zone de contenu ou d’une zone de page.


trailer Indique l’objet subform ou subformSet devant être placé en bas d’une zone de contenu ou d’une zone de page.




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.




Aucun


content, classe catégorie

3.8.3. Propriétés


{default} Représente la valeur réelle stockée par un objet. Booléen 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.



Modèle de formulaire corneredgeextrasfillmargin



3.9.3. Propriété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.



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.




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.3. Propriété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.


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.


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.


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.


bookendLeader (désapprouvée)

(bookendLeader) Indique un sous-formulaire à placer dans la zone de contenu ou la page active avant tout autre contenu.


bookendTrailer (désapprouvée)

Indique le sous-formulaire à placer dans la zone de contenu ou la page active après tout autre contenu.


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.


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.


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


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.





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).



Modèle de formulaire script









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.


26

Objets de script 3

27






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).






Objets de script








targetType Indique les contraintes de déplacement vers une nouvelle page ou zone de contenu avant la disposition du sous-formulaire parent.






3.12.4. Méthodes

Aucun

28

Objets de script 3

3.13. button

29

L’objet button décrit un bouton de commande.








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é).




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.



Modèle de formulaire extrasmessagescript





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.




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.



Modèle de formulaire extrasfontmarginparavalue





placement Indique l’emplacement de la légende. Chaîne Lecture/écriture


reserve Mesure indiquant la hauteur ou la largeur d’une légende. Chaîne Lecture/écriture



3.15.4. Méthodes

Aucun

Objets de script

3.16. certificate

L’objet certificate contient un certificat.





textNode, classe catégorie





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.



Modèle de formulaire issuerskeyUsageoidssigningsubjectDNs





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).


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



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.



Modèle de formulaire borderextrasmargin





allowNeutral Indique si la case à cocher ou le bouton radio prend en charge un troisième état représentant une valeur neutre.


mark Indique la forme à utiliser lors du remplissage d’un objet de case à cocher.


shape Indique si le contour de la case à cocher ou du bouton radio est carré ou rond.


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.




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.








commitOn Indique lorsque les sélections de l’utilisateur sont transmises au modèle de données.


open Détermine le moment où la liste à choix multiples est présentée par les applications interactives.


textEntry Détermine si un utilisateur peut saisir une valeur dans une liste déroulante.




Objets de script

3.19.4. Méthodes

Aucun

3.20. color

L’objet color décrit une couleur unique sur un formulaire.








cSpace Spécifie l’espace colorimétrique. 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.








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



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.



Modèle sourceSet deleteinsertqueryupdate





timeout Spécifie le nombre de secondes autorisé pour la tentative d’exécution de la requête.




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.




connectStringpasswordpictureuser







delayedOpen Spécifie la durée, en secondes, du délai d’ouverture de la source de données une fois la connexion établie.




timeout Spécifie le nombre de secondes autorisé pour la tentative d’exécution de la requête.


usage Spécifie les contextes d’utilisation de la connexion. 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.



Modèle connectionSet wsdlConnectionxsdConnection


model, classe catégorie


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.



Modèle sourceSet Aucun







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.





container, classe



h Mesure de la hauteur pour la disposition. Chaîne Lecture/écriture





w Mesure indiquant la largeur pour la disposition. 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.



Modèle de formulaire colorextras





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).


join Indique la forme d’un coin. 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




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.



Modèle de données dataGroup (désapprouvé)dataValue




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.



Modèle de données dataWindow




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



Modèle de données none





{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.




isNull Indique si la valeur de données actuelle est la valeur nulle. Booléen 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.



Modèle de données none


object, classe catégorie



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


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.



Modèle de formulaire Aucun



48

Objets de script 3


49






3.32.4. Méthodes

Aucun

3.33. dateTime

L’objet dateTime représente une valeur de date et d’heure.






Objets de script







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.



Modèle de formulaire bordercombextrasmargin



50

Objets de script 3


51


hScrollPolicy Indique si un champ peut défiler horizontalement. 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.






Objets de script



{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.


leadDigits Indique le nombre maximum de chiffres (inclusifs) précédant la décimale à capturer et à stocker.





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.






52

Objets de script 3


53




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.






Objets de script





3.37.4. Méthodes

Aucun

3.38. desc

L’objet desc décrit des métadonnées affichables.






54

Objets de script 3


55




3.38.4. Méthodes


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.






Objets de script





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.



Modèle de formulaire digestMethod



56

Objets de script 3


57


type Spécifie le modèle utilisé par un objet. Chaîne Read \Write



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.



Modèle de formulaire assistbordercaptiondescextrasfontkeepmarginparatraversaluivalue

Objets de script


container, classe




anchorType Indique l’emplacement du point d’ancrage du conteneur lors de l’utilisation d’une stratégie de disposition positionnée.





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.


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


rawValue Indique la valeur non formatée de l’objet actuel. 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



vAlign Indique l’alignement de texte vertical. Chaîne Lecture/écriture







3.41.4. Méthodes

Aucun

3.42. dSigData

L’objet dSigData décrit une unité de données de signature numérique XML.




Objets de script







3.42.4. Méthodes



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.




60

Objets de script 3


61




cap Spécifie le rendu d’extrémité du contour. 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



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.



Modèle connectionSet Aucun

Objets de script







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.






62

Objets de script 3


63




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.










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.



Modèle de formulaire encoding








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.



Modèle de formulaire certificate







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.








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.






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.



Modèle Event Aucun





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.


commitKey Indique comment l’utilisateur a défini la valeur actuelle d’un champ de formulaire.


fullText Représente la valeur pleine (non tronquée) que l’utilisateur colle dans un champ de formulaire.


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.


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.


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.


prevContentType Indique le type de contenu de la valeur spécifiée pour la propriété prevText.


prevText Indique le contenu du champ avant qu’il soit modifié suite aux actions de l’utilisateur.


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.


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.


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.


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.


soapFaultString Indique le message descriptif correspondant à un code incorrect lors de la connexion à un service Web particulier.




3.49.4. Méthodes


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.



Modèle de formulaire assistbindbordercalculatecaptiondesc

extrasfieldmarginparatraversalvalidate



Objets de script




access Définit l’accès de l’utilisateur au contenu d’un objet conteneur, tel qu’un sous-formulaire.


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.




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



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



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


70

Objets de script 3

71





rawValue Indique la valeur non formatée de l’objet actuel. 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.




validationMessage Indique la chaîne de message de validation pour ce champ. Chaîne Lecture/écriture








Objets de script

3.50.4. Méthodes


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.






72

Objets de script 3


73





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.


transferEncoding Indique le codage du contenu binaire dans le document référencé. 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é.




Objets de script







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.


runAt Indique quelle application peut exécuter le script. 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.




74

Objets de script 3


75




archive Spécifie l’emplacement URI d’un fichier d’archive pouvant contenir un code de programmation associé à l’objet exObject.


classId Spécifie un nom ou un emplacement URI pour le code de programmation représenté par l’objet.


codeBase Spécifie un emplacement URI pouvant être utilisé pour faciliter la résolution d’une propriété classId .


codeType Spécifie un identifiant de type MIME capable d’identifier le code de programmation représenté par l’objet.




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.




none

Objets de script








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



Modèle de formulaire assistbindbordercalculatecaptionconnectdescextrasfont

formatitemskeepmarginparatraversaluivalidatevalue

Objets de script


container, classe



{default} Représente la valeur réelle stockée par un objet. Variable 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.








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


fontColor Spécifie la valeur de la couleur de premier plan pour ce champ. Elle équivaut à l’expression font.fill.color.value.


formatMessage Indique la chaîne de message pour la validation du format pour ce champ.


formattedValue Indique la valeur formatée pour le champ. Chaîne Lecture/écriture

78

Objets de script 3

79



length Indique le nombre d’objets dans la liste. Entier Lecture



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





parentSubform Indique le sous-formulaire (page) parent du champ. Objet Lecture


rawValue Indique la valeur non formatée de l’objet actuel. Variable Lecture/écriture



rotate Fait pivoter l’objet autour de son point d’ancrage selon l’angle indiqué.


selectedIndex Index du premier élément sélectionné. Entier Lecture/écriture



Objets de script


validationMessage Indique la chaîne de message de validation pour ce champ. Chaîne Lecture/écriture








3.55.4. Méthodes


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


Vide



Vide


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


3.56. fill

L’objet fill applique une couleur et des conceptions rendues facultatives à la zone délimitée par un objet.











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.


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 de formulaire certificatesdigestMethodsencodingshandlermdpreasonstimeStamp





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).



82

Objets de script 3

83


version Indique le numéro de version de l’application active.


3.57.4. Méthodes

Aucun

3.58. float

L’objet float décrit une valeur à virgule flottante.








{default} Représente la valeur réelle stockée par un objet. Double 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.



Modèle de formulaire extrasfill





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.


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é).


lineThroughPeriod Contrôle l’aspect de la ligne sur le texte (propriété également connue sous le nom de texte barré).


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.


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



weight Définit l’épaisseur d’une police de caractères. Chaîne Lecture/écriture


3.59.4. Méthodes

Aucun

Objets de script

3.60. form

L’objet form constitue l’objet racine du modèle de formulaire.








checksum Indique un algorithme de la somme de contrôle à insérer dans un code à barres.


3.60.4. Méthodes



Vide


Vide


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


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


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.



Modèle de formulaire extraspicture







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.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.



Modèle Host Aucun





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.


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


3.63.4. Méthodes


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


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.






Objets de script



excludeAllCaps Indique s’il faut ou non appliquer la césure aux mots écrits entièrement en majuscules.


excludeInitialCap Indique s’il faut ou non appliquer la césure aux mots dont l’initiale est une lettre majuscule.


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.


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é.


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é.




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.


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.








{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.




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é.




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.








data Indique si l’image fournie au widget doit être désignée comme référence ou incorporée.




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.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.



Modèle de formulaire occur





count Indique le nombre actuel d’instances de sous-formulaire sur un formulaire.


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


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


3.69. integer

L’objet integer décrit une valeur sous forme d’entier.




Aucun





{default} Représente la valeur réelle stockée par un objet. Entier Lecture/écriture


Objets de script


value Indique la valeur de l’objet actuel. Entier Lecture/écriture


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.






98

Objets de script 3


99





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.






Objets de script






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.




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.






100

Objets de script 3


101


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.


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.


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.




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é.




Objets de script





crlSign Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.


dataEncipherment

Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.


decipherOnly Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.


digitalSignature Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.


encipherOnly Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.


keyAgreement Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.


keyCertSign Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.


keyEncipherment



nonRepudiation Indique une extension d’utilisation des clés acceptable devant être présente dans le certificat de signature.





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).



Modèle Layout Aucun





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


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


104

Objets de script 3

3.75. line

105

L’objet line décrit une ligne unique générée sur un formulaire.



Modèle de formulaire edge






slope Indique l’orientation de la ligne. 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.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.








{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.




Objets de script

3.77.4. Méthodes


evaluate Récupère la liste des objets référencée dans l’élément Manifest. Objet


Vide


Vide


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.






108

Objets de script 3


109


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.


from Spécifie le nom original de la colonne dans la source de données. 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.






Objets de script



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



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.






110

Objets de script 3


111


permissions Spécifie les droits d’accès accordés pour un formulaire qui inclut la signature de l’auteur.


signatureType Indique le mode d’enregistrement d’un formulaire comportant une signature du document comme document PDF certifié.




3.80.4. Méthodes

Aucun

3.81. medium

L’objet medium décrit un support physique sur lequel effectuer des rendus.






Objets de script



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.


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.


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



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.



Modèle de formulaire text

112

Objets de script 3


113






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.



Modèle de formulaire bordercombextrasmargin



Objets de script






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.



Modèle de formulaire extrasscript (occur.scriptest réservé pour une utilisation ultérieure)



114

Objets de script 3


115


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



min Indique le nombre minimal d’occurrences du conteneur englobant. 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.






Objets de script





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.






116

Objets de script 3


117





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.






Objets de script



input Spécifie un message d’entrée associé à une opération de connexion WSDL particulière.


output Spécifie le message de sortie associé à une opération de connexion WSDL particulière.




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.






118

Objets de script 3


119









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.



Modèle XFA Aucun



Objets de script



content Indique le contenu de l’objet. Chaîne Lecture/écriture

3.89.4. Méthodes



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.



Modèle de formulaire descextrasmediumoccur


container, classe

120

Objets de script 3


121


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.


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.


numbered Spécifie si la zone de page est assimilée à une zone de page numérotée.


oddOrEven Indique si une page est paire ou impaire pour la pagination d’un jeu de pages.


pagePosition Indique une position de la page dans un jeu de pages. 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.



Modèle de formulaire extrasoccur

Objets de script


container, classe



duplexImposition Contrôle l’orientation de l’image de la page lors de l’impression des deux côtés.


relation Indique les rapports qu’entretiennent les membres du jeu. 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.



Modèle de formulaire hyphenation

122

Objets de script 3


123





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.


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.


spaceBelow Indique la quantité d’espacement vertical et la taille maximale de police sur la première ligne d’un paragraphe.


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.


textIndent Indique la position horizontale de la première ligne par rapport au reste d’un paragraphe.





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.


wordSpacingMinimum

Définit l’espace intermots minimum (en pourcentage) lorsque le texte est justifié et/ou si la césure est activée.


wordSpacingOptimum

Définit l’espace intermots optimal (en pourcentage) lorsque le texte est justifié et/ou si la césure est activée.



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).










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.









passwordChar Indique le caractère visible à l’écran lorsqu’un utilisateur saisit un mot de passe dans le formulaire.




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.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.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.





Aucun


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.



Modèle sourceSet recordSetselect

128

Objets de script 3


129




commandType Spécifie le type de commande utilisé par une requête de données.




3.98.4. Méthodes

Aucun

3.99. radial

L’objet radial décrit un remplissage dégradé radial.






Objets de script






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.






130

Objets de script 3


131




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.






Objets de script






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.






132

Objets de script 3


133


bofAction Spécifie l’opération à effectuer si l’enregistrement actif est le premier du jeu d’enregistrements.


cursorLocation Indique l’emplacement de la bibliothèque de curseurs à utiliser avec le jeu d’enregistrements.


cursorType Spécifie le type de curseur à utiliser à l’ouverture du jeu d’enregistrements.


eofAction Spécifie l’opération à effectuer si l’enregistrement actif est le dernier du jeu d’enregistrements.


lockType Indique le type de fonction de verrouillage à utiliser avec la source de données.






3.102.4. Méthodes

Aucun

Objets de script

3.103. rectangle

L’objet rectangle décrit un rectangle généré unique.



Modèle de formulaire corneredgefill








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.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.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.









binding Identifie le type d’application auquel s’adresse le script. 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.





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.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.



Modèle de formulaire ref








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.



Modèle de formulaire borderextrasfiltermanifestmargin





type (signature.typeest réservé pour une utilisation ultérieure)

Spécifie le modèle utilisé par un objet. 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.4. Méthodes

Aucun

Objets de script

3.111. signaturePseudoModel

L’objet signaturePseudoModel constitue l’objet racine du modèle de signature.



Modèle de signature Aucun



3.111.3. Méthodes


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.



Modèle de formulaire filtermanifestref





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.





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.4. Méthodes

Aucun

144

Objets de script 3

3.114. soapAction

145

L’objet soapAction contient une action SOAP complète.










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.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.4. Méthodes

Aucun

Objets de script

3.117. source

L’objet source représente une source de données externe.



Modèle sourceSet connect





db Spécifie la technologie utilisée pour communiquer avec une base de données.




3.117.4. Méthodes


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


Objets de script

3.118. sourceSet

La propriété sourceSet constitue l’objet racine du modèle sourceSet.



Modèle sourceSet source







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.








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.




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.








rate Spécifie le pourcentage de motif grisé sur un arrière-plan plein. 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)



Modèle de formulaire

assistbindbookendborderbreak (désapprouvé)breakAfterbreakBeforecalculateconnectdesceventexObject

extrasinstanceManagerkeepmarginoccuroverflowparasetPropertytraversalvalidatevariable


container, classe





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.


Objets de script







columnWidths Spécifie la largeur des colonnes d’un tableau. 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.


layout Indique la stratégie de disposition utilisée par cet objet. Chaîne Lecture/écriture





mergeMode Commandes dont l’algorithme de fusion de données est utilisé pour un sous-formulaire donné.





154

Objets de script 3

155




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.


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.




validationMessage

Indique la chaîne de message de validation pour ce champ. Chaîne Lecture/écriture








Objets de script

3.121.4. Méthodes



Vide



Vide


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.



Modèle de formulaire bookendbreak (désapprouvée)descextrasinstanceManageroccuroverflow


container, classe

156

Objets de script 3


157


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.


relation Indique les rapports qu’entretiennent les membres du jeu. Chaîne Lecture





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.




Objets de script





delimiter Sépare les attributs dans la chaîne Pseudo PS. 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).



Modèle de formulaire subjectDN



158

Objets de script 3


159





3.124.4. Méthodes

Aucun

3.125. submit

L’objet submit décrit comment envoyer des données à un hôte.



Modèle de formulaire encrypt



Objets de script



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


textEncoding Indique le codage du contenu de texte dans un document. 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.


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.




160

Objets de script 3


161



Aucun.

3.126.4. Méthodes


createNode Crée un nouveau nœud en fonction d’un nom de classe correct. Objet


Vide


Vide


Vide

formNodes Renvoie la liste de tous les objets de modèle du formulaire liés à un objet de données spécifié.

Objet


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.




Aucun




3.127.4. Méthodes



maxChars Indique le nombre maximal de caractères que cette valeur de texte peut englober.





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.



Modèle de formulaire bordercomb (textEdit.combest réservé pour une utilisation ultérieure)extrasmargin





allowRichText

Indique si le texte est compatible avec les styles (ce qu’on appelle également du texte enrichi).


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



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.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é.








server Indique l’URL pour un serveur de tampons temporels. 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.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.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.



Modèle de formulaire extrasscript





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.






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.



Modèle de formulaire extraspicture







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.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.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.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.



Modèle de formulaire extrasmessagepicturescript





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.


scriptTest Contrôle la validation effectuée par le script inclus. 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.








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.






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.





container, classe





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.4. Méthodes

Aucun

176

Objets de script 3

3.142. wsdlConnection

177

L’objet wsdlConnection identifie une connexion unique aux services Web WSDL.



Modèle connectionSet effectiveInputPolicyeffectiveOutputPolicyoperationsoapActionsoapAddresswsdlAddress





dataDescription Spécifie le nom de la description d’une connexion aux données à utiliser avec un type particulier de connexion aux services Web.


3.142.4. Méthodes


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.



Modèle XFA packet




Aucun


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.



Modèle connectionSet uri







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.



Modèle connectionSet rootElementuri







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


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"


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


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


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


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


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


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


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


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.


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"


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


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


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)"


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


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"


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


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


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


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


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


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


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


4.16.3. Application

203

Modèle Objet


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"


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


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";


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


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"


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


208


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.


4.21.3. Application

Modèle Objet


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


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



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)


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


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


4.25.1. Syntaxe

Reference_Syntax.blankOrNotBlank = "any | blank | notBlank"


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


4.25.4. Version

XFA 2.5

4.25.5. Exemples


4.25.6. JavaScript

xfa.form.form1.pageSet.Page1.blankOrNotBlank = "notBlank";

214


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


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


4.27.4. Version

XFA 2.1

4.27.5. Exemples

4.27.6. JavaScript

Subform1.break.bookendLeader = "xfa.form.form1.Subform2";

216


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


4.28.3. Application

Modèle Objet


4.28.4. Version

XFA 2.1


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


218


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)


4.30.3. Application

Modèle Objet



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



4.31.3. Application

Modèle Objet

Modèle de formulaire margin

220


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


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


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


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


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.


Reference_Syntax.cancelAction = false | true; - or - Reference_Syntax.cancelAction = 0 | 1;


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





224


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 :





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


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


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



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


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


• fontSpecific


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


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



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.


Reference_Syntax.circular = false | true; - or - Reference_Syntax.circular = 0 | 1;


Reference_Syntax.circular = 0 | 1

232


4.39.3. Valeurs

233

Type Valeurs


• 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


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


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


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.


4.42.1. Syntaxe

Reference_Syntax.classIndex = "integer"


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.


4.43.1. Syntaxe

Reference_Syntax.className = "string"

236


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


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"


4.44.2. Valeurs

Type Valeurs

Chaîne Valeur URI complètement qualifiée.

4.44.3. Application

Modèle Objet


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


4.45.3. Application

239

Modèle Objet


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


• Tout nombre entier valide.


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


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


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"


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


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


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


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


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


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


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.


4.52.3. Application

Modèle Objet


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


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



Chaîne Un script FormCalc.


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 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


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


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"


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


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


4.58. crlSign


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


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"


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


4.60.4. Version

XFA 2.1

4.60.5. Exemples

4.60.6. JavaScript

xfa.host.currentPage = "2";

256


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


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


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


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


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


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"


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


4.64.3. Application

261

Modèle Objet


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.


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


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


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"


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


4.68. dataEncipherment

265


4.68.1. Syntaxe

Reference_Syntax.dataEncipherment = "Yes | No | empty_string"

4.68.2. Valeurs

Type Valeurs

Chaîne • Yes (par défaut)

• No

• ""


• No

• ""


• ""


4.68.3. Application

Modèle Objet


4.68.4. Version

XFA 2.5


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


4.69.4. Version

XFA 2.1

266


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


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


• 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


4.71.3. Application

269

Modèle Objet


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.


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


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


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


4.73.4. Version

XFA 2.1


4.74. decipherOnly


4.74.1. Syntaxe

Reference_Syntax.decipherOnly = "Yes | No | empty_string"

4.74.2. Valeurs

Type Valeurs


• No

• ""


• No

• ""


• ""


4.74.3. Application

Modèle Objet


4.74.4. Version

XFA 2.5

272


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


4.75.6. JavaScript

xfa.sourceSet.Titles.connect.delayedOpen = "5";

4.75.7. FormCalc

xfa.sourceSet.Titles.connect.delayedOpen = "5"


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


4.77. digitalSignature

275


4.77.1. Syntaxe

Reference_Syntax.digitalSignature = "Yes | No | empty_string"

4.77.2. Valeurs

Type Valeurs


• No

• ""


• No

• ""


• ""


4.77.3. Application

Modèle Objet


4.77.4. Version

XFA 2.5


4.78. disable

Désactive l’invite audible.

4.78.1. Syntaxe

Reference_Syntax.disable = "1 | 0"

4.78.2. Valeurs

Type Valeurs


• 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


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


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


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"


4.82.2. Valeurs

Type Valeurs


• 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


4.83. encipherOnly

281


4.83.1. Syntaxe

Reference_Syntax.encipherOnly = "Yes | No | empty_string"

4.83.2. Valeurs

Type Valeurs


• No

• ""


• No

• ""


• ""


4.83.3. Application

Modèle Objet


4.83.4. Version

XFA 2.5


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


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


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


4.85.4. Version

XFA 2.1


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


Pour PDF417, les valeurs admises sont des entiers compris entre 0 et 8 (inclus).

4.86.3. Application

Modèle Objet


4.86.4. Version

XFA 2.1

4.86.5. Exemples

4.86.6. JavaScript

Code11BarCode1.resolveNode("ui.#barcode").errorCorrectionLevel = "5";

284


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


4.87.4. Version

XFA 2.9


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


4.88.4. Version

XFA 2.8

286


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


4.89.4. Version

XFA 2.8


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


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


4.91.4. Version

XFA 2.1


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


4.92.3. Application

291

Modèle Objet


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.


4.93.3. Application

Modèle Objet


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


4.94.3. Application

293

Modèle Objet


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"


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

• pdf

Les données sont conditionnées au format XDP.

• formdata

• pdf

Les données sont conditionnées et codées au format URL selon les spécifications URL (Uniform Resource Locators).

• pdf

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


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


4.96.4. Version

XFA 2.1


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


4.97.4. Version

XFA 2.1

296


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"


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




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.




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 :



298


4.98.3. Application

299

Modèle Objet


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"


4.99.2. Valeurs

Type Valeurs


• 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


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


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.


Modèle Objet


4.101.4. Version

XFA 2.1

4.101.5. Exemples

4.101.6. JavaScript

xfa.event.fullText;

302


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




Modèle Objet


4.102.4. Version

XFA 2.1


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


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


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"


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



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"


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).


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


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


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";


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



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"


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.


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



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


• 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.


Modèle Objet

Modèle de formulaire medium


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.


tree, classe classe

314


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 valide représentant n’importe quel entier correct.



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


4.113.2. Valeurs

317

Type Valeurs


• Chaîne valide représentant n’importe quelle entier.


Modèle Objet


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"


4.114.2. Valeurs

Type Valeurs

Chaîne Chaîne valide représentant un message d’entrée.


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



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.



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


4.117.2. Valeurs

321

Type Valeurs


• 1

Le coin est convexe.

• 1

Le coin est concave.


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"


4.118. isContainer

Indique si l’objet est un objet conteneur.



Reference_Syntax.isContainer = false | true; - or - Reference_Syntax.isContainer = 0 | 1;


Reference_Syntax.isContainer = 0 | 1

4.118.3. Valeurs

Type Valeurs


• false | 0

L’objet est un type d’objet conteneur.

• false | 0

L’objet n’est pas un type d’objet conteneur.


node, classe classe

4.118.5. Version

XFA 2.1

322


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.



Reference_Syntax.isDefined = false | true; - or - Reference_Syntax.isDefined = 0 | 1;


Reference_Syntax.isDefined = 0 | 1


4.119.3. Valeurs

Type Valeurs


• 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.


Modèle Objet


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


4.120. isNull

325

Indique si la valeur de données actuelle est la valeur nulle.


Reference_Syntax.isNull = false | true; - or - Reference_Syntax.isNull = 0 | 1;


Reference_Syntax.isNull = 0 | 1

4.120.3. Valeurs

Type Valeurs


• 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.


node, classe class

Modèle Objet



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


• 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



327

Modèle Objet


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"


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.


Modèle Objet


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


4.123. keyAgreement

329


4.123.1. Syntaxe

Reference_Syntax.keyAgreement = "Yes | No | empty_string"

4.123.2. Valeurs

Type Valeurs


• No

• ""


• No

• ""


• ""



Modèle Objet


4.123.4. Version

XFA 2.5


4.124. keyCertSign


4.124.1. Syntaxe

Reference_Syntax.keyCertSign = "Yes | No | empty_string"

4.124.2. Valeurs

Type Valeurs


• No

• ""


• No

• ""


• ""



Modèle Objet


4.124.4. Version

XFA 2.5

330


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


Modèle Objet


4.125.4. Version

XFA 2.1

4.125.5. Exemples

4.125.6. JavaScript

xfa.event.keyDown;


4.125.7. FormCalc

xfa.event.keyDown

4.126. keyEncipherment


4.126.1. Syntaxe

Reference_Syntax.keyEnciphement = "Yes | No | empty_string"

4.126.2. Valeurs

Type Valeurs


• No

• ""


• No

• ""


• ""



Modèle Objet


332


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.


Modèle Objet

Modèle de formulaire bindItems

4.127.4. Version

XFA 2.4


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.


Modèle Objet


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


4.129.2. Valeurs

335

Type Valeurs

Chaîne Chaîne valide représentant la langue de la version de l’ordinateur hôte.


Modèle Objet


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"


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


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


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


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 valide représentant n’importe quelle valeur entière.


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


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.


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";


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




Modèle Objet


4.133.4. Version

XFA 2.1

4.133.5. Exemples

4.133.6. JavaScript

Subform1.margin.leftInset = "0.25in";

340


4.133.7. FormCalc

341

Subform1.margin.leftInset = "0.25in"

4.134. length

Indique le nombre d’objets dans la liste.


4.134.1. Syntaxe

Reference_Syntax.length

4.134.2. Valeurs

Type Valeurs

Entier Entier valide représentant le nombre d’objets.


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);


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



343

Modèle Objet


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"


4.136.2. Valeurs

Type Valeurs

Chaîne • 0pt(par défaut)



Modèle Objet


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


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


• 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.


Modèle Objet


4.137.4. Version

XFA 2.1


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.


Modèle Objet


346


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.



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



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"


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.


Modèle Objet


350


4.141.4. Version

351

XFA 2.1

4.141.5. Exemples


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





Modèle Objet


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



353

Modèle Objet


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.



Modèle Objet


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



354



355

Modèle Objet


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





Modèle Objet


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


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


Modèle Objet


4.147.4. Version

XFA 2.5


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


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


Modèle Objet

Modèle de formulaire 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"


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


• -1

• Tout entier valable.

Aucune limite supérieure n’est définie.



Modèle Objet

Modèle de formulaire instanceManageroccur


4.149.4. Version

XFA 2.1

360


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



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"


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




Modèle Objet


4.151.4. Version

XFA 2.1

362


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)




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



364



365

Modèle Objet


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"


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.


Modèle Objet


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


4.155.2. Valeurs

367

Type Valeurs




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


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




Modèle Objet


4.156.4. Version

XFA 2.1

4.156.5. Exemples

4.156.6. JavaScript

TextField1.minH = "0.5in";

368


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




Modèle Objet


4.157.4. Version

XFA 2.1


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.


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.


node, classe classe

4.158.4. Version

XFA 2.1

370


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.


Reference_Syntax.modifier = false | true; - or - Reference_Syntax.modifier = 0 | 1;


Reference_Syntax.modifier = 0 | 1

4.159.3. Valeurs

Type Valeurs


• 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.



Modèle Objet


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


4.160.2. Valeurs

373

Type Valeurs

Chaîne • 5 mm(valeur par défaut pour les codes à barres 2D)


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.


Modèle Objet


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"


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)



Modèle Objet


374


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


• 0

Le texte peut couvrir plusieurs lignes.

• 0

Le texte est limité à une seule ligne.



Modèle Objet


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


4.163.2. Valeurs

377

Type Valeurs

Chaîne Chaîne pouvant comprendre jusqu’à 255 caractères.


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


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.


Modèle Objet


4.164.4. Version

XFA 2.1

378


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



Modèle Objet


4.165.4. Version

XFA 2.1


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


• 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


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


Modèle Objet


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"


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.


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.


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


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


4.168.1. Syntaxe

Reference_Syntax.nonRepudiation = "Yes | No | empty_string"

4.168.2. Valeurs

Type Valeurs


• No

• ""


• No

• ""


• ""




Modèle Objet


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.


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é.


node, classe classe

4.169.4. Version

XFA 2.1

384


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.


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



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



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 :



Type Valeurs


Modèle Objet


4.170.4. Version

XFA 2.1

386


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


• 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.



Modèle Objet


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


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.


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"


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.


Modèle Objet


4.173.4. Version

XFA 2.1

4.173.5. Exemples

4.173.6. JavaScript

xfa.host.numPages;

390


4.173.7. FormCalc

391

xfa.host.numPages


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


• 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.



Modèle Objet


4.174.4. Version

XFA 2.5

4.174.5. Exemples


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



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"


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.


Modèle Objet


4.176.4. Version

XFA 2.1

394


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


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


Modèle Objet

Modèle connectionSet wsdlConnection

Modèle de formulaire signDatatraverse

4.177.4. Version

XFA 2.4

396


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.


Modèle Objet


4.178.4. Version

XFA 2.1

4.178.5. Exemples

4.178.6. JavaScript

xfa.form.form1.pageSet.Page1.medium.orientation = "landscape";


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.


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


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



Modèle Objet


4.180.4. Version

XFA 2.1


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.


Modèle Objet


4.181.4. Version

XFA 2.1

400


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



Modèle Objet



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


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




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



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



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 :



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


Modèle Objet

Modèle de formulaire calculatevalue

404


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


• first

• last

• rest

• only


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


Modèle Objet


4.184.4. Version

XFA 2.5

4.184.5. Exemples


406


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.


4.185.1. Syntaxe

Reference_Syntax.parent

4.185.2. Valeurs

Type Valeurs

Objet Un modèle d’objet de formulaire XML.


tree, classe classe

4.185.4. Version

XFA 2.1


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.


Modèle Objet


408


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.


Modèle Objet

Modèle de formulaire passwordEdit


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


411


• 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


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"


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.


Modèle Objet

Modèle de formulaire caption

412


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.


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.



Modèle Objet


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


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.


Modèle Objet


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"


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



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


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


• 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.


Modèle Objet


418


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.



Modèle Objet


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


4.195.2. Valeurs

421

Type Valeurs


• 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.


Modèle Objet


4.195.4. Version

XFA 2.1

4.195.5. Exemples

4.195.6. JavaScript

Subform1.keep.previous = "contentArea";


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



Modèle Objet


4.196.4. Version

XFA 2.1

4.196.5. Exemples

4.196.6. JavaScript

xfa.event.prevText;

422


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


• 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.


Modèle Objet



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


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


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"


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.


Modèle Objet


4.199.4. Version

XFA 2.8

426


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




Modèle Objet


4.200.4. Version

XFA 2.1


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




Modèle Objet


4.201.4. Version

XFA 2.1

428


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


• 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é.



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


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.


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";


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.



Reference_Syntax.ready;


Reference_Syntax.ready

432


4.204.3. Valeurs

433

Type Valeurs


Le processus de disposition est terminé.

• false | 0

Le processus de disposition n’est pas terminé.


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


4.205. recordsAfter

Renvoie le nombre d’enregistrements dans la fenêtre de données après l’enregistrement en cours.


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.


Modèle Objet


4.205.4. Version

XFA 2.1

4.205.5. Exemples

4.205.6. JavaScript

xfa.dataWindow.recordsAfter;

434


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.


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.


Modèle Objet


4.206.4. Version

XFA 2.1


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.


Reference_Syntax.reenter = false | true; - or -Reference_Syntax.reenter = 0 | 1;


Reference_Syntax.reenter = 0 | 1

436


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.


Modèle Objet


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


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.


Modèle Objet

Modèle de formulaire bindbindItemsconnecteventitemstraverse

Modèle sourceSet bindconnect

4.208.4. Version

XFA 2.1

438


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.


Modèle Objet

Modèle de formulaire subformSet


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



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


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.


Modèle Objet


4.211.4. Version

XFA 2.8

442


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




Modèle Objet

Modèle de formulaire caption

4.212.4. Version

XFA 2.1


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


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.


Si le sous-formulaire racine utilise cette valeur, les propriétés suivantes sont enregistrées et restaurées :


• Toutes les informations sur l’état sont restaurées à l’aide de la méthode restore.


• 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 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 :




Type Valeurs



Modèle Objet


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



446



447

Modèle Objet


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"


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).


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


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


• Toute mesure d’angle valable.


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";


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.


Modèle Objet


4.217.4. Version

XFA 2.1

450


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.



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


4.219.2. Valeurs

453

Type Valeurs


• 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.


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"


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é.


Modèle Objet


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


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.


Modèle Objet


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"


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



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



456


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



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 :



Type Valeurs


Modèle Objet


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"


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.


Modèle Objet


4.223.5. Version

XFA 2.5

458


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.


Modèle Objet


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


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.


Modèle Objet


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


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.


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"


4.227.2. Valeurs

Type Valeurs


• round

Le bouton s’affiche avec un contour carré.

• round

Le bouton s’affiche avec un contour rond.


Modèle Objet


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


4.228. shift

463

Indique si la touche Maj est enfoncée lors d’un événement donné.


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


• 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.


Modèle Objet


4.228.5. Version

XFA 2.1


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




Modèle Objet


464


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.



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)


• 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



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 = "\ | /"


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.


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


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.


Modèle Objet


4.233.4. Version

XFA 2.1


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.


Modèle Objet


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


4.235.2. Valeurs

471

Type Valeurs

Chaîne Chaîne valide représentant une expression de syntaxe de référence complète.


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"


4.236.2. Valeurs

Type Valeurs




Modèle Objet


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


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




Modèle Objet


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"


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


• Valeur supérieure à 0 et inférieure ou égale à 360.


Modèle Objet


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


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.


Modèle Objet


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 = "*"


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


• 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).


Modèle Objet

Modèle de formulaire break (désapprouvé)breakAfterbreakBefore

4.240.4. Version

XFA 2.1

476


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


• 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).


Modèle Objet



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.


Modèle Objet


478


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


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


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


Modèle Objet

Modèle de formulaire corneredge

4.243.4. Version

XFA 2.1


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


• Une valeur inférieure à 360 et supérieure ou égale à 0.


Modèle Objet


4.244.4. Version

XFA 2.1

482


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.


Modèle Objet


4.245.4. Version

XFA 2.1


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


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.


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


Modèle Objet


486


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.



Modèle Objet


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


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.



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


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


• 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


• ISO-8859-7

• Shift-JIS

• KSC-5601

• Big-Five

• GB-2312

• UTF-8

• UTF-16

• UCS-2

• fontSpecific


• Shift-JIS

• KSC-5601

• Big-Five

• GB-2312

• UTF-8

492


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


• UCS-2

• fontSpecific


• UTF-16

• UCS-2

• fontSpecific


• 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.


Modèle Objet


4.249.4. Version

XFA 2.1

4.249.5. Exemples

4.249.6. JavaScript

Button1.event.submit.textEncoding = "UCS-2";

494


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


• 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.


Modèle Objet


4.250.4. Version

XFA 2.1


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




Modèle Objet


496


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"


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.


Modèle Objet


498


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)




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.


4.254.1. Syntaxe

this

500


4.254.2. Valeurs

501

Type Valeurs

Objet L’objet actif.


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


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.


Modèle Objet

Modèle sourceSet commandconnect

4.255.4. Version

XFA 2.1

4.255.5. Exemples


4.255.6. JavaScript

xfa.sourceSet.Titles.connect.timeout = "10";

4.255.7. FormCalc

xfa.sourceSet.Titles.connect.timeout = "10"

502


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.


Modèle Objet

Modèle XFA xfa

4.256.4. Version

XFA 2.1


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.


Modèle Objet


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


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




Modèle Objet


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"


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.


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


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


• 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.


Modèle Objet

Modèle de formulaire exDataimage



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


• 1

La valeur du groupe d’exclusion doit être sauvegardée.

• 1

Le groupe d’exclusion ne doit pas être sauvegardé.


Modèle Objet

Modèle de formulaire exclGroup

4.261.4. Version

XFA 2.1

508


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


• 1

Inclut la marque de synchronisation du système droitier.

• 1

Omet la marque de synchronisation du système droitier.


Modèle Objet


4.262.4. Version

XFA 2.1


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


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


• 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


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


• 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


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


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



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.



Modèle Objet


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


4.265.2. Valeurs

519

Type Valeurs


• 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.


Modèle Objet


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"


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.


Modèle Objet


4.266.4. Version

XFA 2.1

4.266.5. Exemples

4.266.6. JavaScript

TextField1.font.underlinePeriod = "word";

520


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).



Modèle Objet


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.


Modèle Objet


4.268.4. Version

XFA 2.5

522


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.


Modèle Objet


4.269.4. Version

XFA 2.5


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.


Modèle Objet

Modèle de formulaire connect

4.270.4. Version

XFA 2.1

524


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.


Modèle Objet

Modèle connectionSet effectiveInputPolicyeffectiveOutputPolicyoperationrootElementsoapActionsoapAddressuriwsdlAddress


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


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)"


Modèle Objet

Modèle connectionSet effectiveInputPolicyeffectiveOutputPolicyoperationrootElementsoapActionsoapAddressuriwsdlAddress

Modèle de formulaire arcareaassistbarcodebookendbooleanborderbreak (désapprouvé)breakAfterbreakBeforebuttoncalculatecaptioncertificatecertificatescheckButtonchoiceListcolorcomb


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.


Modèle Objet

Modèle XFA xfa

4.273.4. Version

XFA 2.1

528


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.


Modèle Objet


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."


4.275. validationsEnabled

Indique si les scripts de validation seront exécutés ou non.


Reference_Syntax.validationsEnabled = false | true; - or - Reference_Syntax.validationsEnabled = 0 | 1;


Reference_Syntax.validationsEnabled = 0 | 1

4.275.3. Valeurs

Type Valeurs


• Les scripts de validation sont désactivés.

• true | 1

• Les scripts de validation sont activés.


Modèle Objet


4.275.5. Version

XFA 2.1

530


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.



Modèle Objet


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


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.


S’applique également aux objets provenant de la classe textNode class.

Modèle Objet


Modèle de formulaire booleancouleurdatedateTimedecimalfloatimageintegerpicturescripttexttime

Modèle sourceSet booleanintegertext

4.277.4. Version

XFA 2.1


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.


4.278.1. Syntaxe

Reference_Syntax.valueRef = "string"

534


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.


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.


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.



Modèle Objet


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.


4.280.1. Syntaxe

Reference_Syntax.version

536


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.


Modèle Objet

Modèle de formulaire handler


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


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


• 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.


Modèle Objet


4.281.4. Version

XFA 2.5

538


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





Modèle Objet


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


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.


Modèle Objet


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"


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.


Modèle Objet


4.284.4. Version

XFA 2.1

542


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.


Modèle Objet


4.285.4. Version

XFA 2.8


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%.


Modèle Objet


4.286.4. Version

XFA 2.8

4.286.5. Exemples

4.286.6. JavaScript

TextField1.para.wordSpacingMaximum = "40%";

544


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



Modèle Objet


4.287.4. Version

XFA 2.8


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



Modèle Objet


546


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





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


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.


Modèle Objet


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 = "*"


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




Modèle Objet

Modèle de formulaire areacontentAreadrawexclGroupfieldsous-formulaire

4.291.4. Version

XFA 2.1

550


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


Version

XFA 2.1

Exemples

JavaScript

TextField2.rawValue = xfa.layout.absPage(this);

FormCalc

TextField2 = xfa.layout.absPage($)


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


Version

XFA 2.1

Exemples

JavaScript

TextField2.rawValue = xfa.layout.absPageCount();

FormCalc

TextField2 = xfa.layout.absPageCount()


5.1.3. absPageCountInBatch

Détermine la quantité de pages du lot actuel.

Syntaxe

Reference_Syntax.absPageCountInBatch()

Version

2.5

Paramètres

Aucun

554


Renvoie

555

Entier représentant la quantité de pages du lot actuel.

Application

Modèle Objet


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


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


Renvoie

Entier représentant le nombre de pages qu’occupe l’objet de formulaire spécifié.

Application

Modèle Objet


Version

XFA 2.1

556


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


Version

XFA 2.1

Exemples

JavaScript

Subform1.instanceManager.addInstance(1);

FormCalc

Subform1.instanceManager.addInstance(1)


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


Renvoie

559

Vide

Application

Modèle Objet


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


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


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


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


Version

XFA 2.1

Exemples

JavaScript

xfa.host.beep("3");

564


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


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


Version

XFA 2.1

Exemples

JavaScript

xfa.sourceSet.dataConnectionName.cancel();

566


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


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é.


• 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


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


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


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


Paramètres

571

param Valeur booléenne indiquant si le clonage se produit de manière récursive.


• Cloner l’objet de manière récursive.


• 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)


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


Version

XFA 2.1

Exemples

JavaScript

xfa.sourceSet.nodes.item(nIndex).close();

FormCalc

xfa.sourceSet.nodes.item(nIndex).close()

572


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")


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


Version

XFA 2.8

574


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


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


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


Renvoie

577

Vide.

Application

Modèle Objet


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


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


Application

579

Modèle Objet


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


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


Version

XFA 2.1

580


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


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


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


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.


• 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


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


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.


• Exporter au XDP Format.


• 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


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


Version

XFA 2.1

590


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


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


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


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


596


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


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


Renvoie

True si l’élément a été sélectionné, false dans le cas contraire.

Application

Modèle Objet


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


Paramètres

599


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


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


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


Renvoie

601

Vide

Application

Modèle Objet


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


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


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


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


Version

XFA 2.1

Exemples

JavaScript

xfa.host.importData ("filename.xdp");

604


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.


• 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


Version

XFA 2.1

606


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


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


Version

XFA 2.1

608


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


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.


• Détermine si cette propriété est héritée d’une classe parent.


• 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


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


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


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


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é.


• 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.


• 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


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


Version

XFA 2.1

616


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


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


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


Application

621

Modèle Objet


Version

XFA 2.1

Exemples

JavaScript

Subform1.instanceManager.moveInstance(0,6);

FormCalc

Subform1.instanceManager.moveInstance(0,6)


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


Version

XFA 2.1

622


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


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.


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


Version

XFA 2.6

XFA 2.1 (désapprouvé)

624


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


Version

XFA 2.1

Exemples

JavaScript

xfa.layout.page(this);

Méthodes de script

FormCalc

xfa.layout.page($)


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


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)


• Renvoie uniquement les nœuds de contenu pageArea.


• 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


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


Version

XFA 2.1

Exemples

JavaScript

xfa.layout.pageCount();

628


FormCalc

629

xfa.layout.pageCount()


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


Version

XFA 2.1

Exemples

JavaScript

xfa.host.pageDown();

Méthodes de script

FormCalc

xfa.host.pageDown()


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


630


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


Version

XFA 2.1

Méthodes de script

Exemples

JavaScript

xfa.host.pageUp();

FormCalc

xfa.host.pageUp()


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


632


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.


• 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.


• N’affiche pas de boîte de dialogue d’annulation lors de processus d’impression.


• Affiche une boîte de dialogue d’annulation permettant d’inter-rompre l’impression.


• Réduit la page (si nécessaire) afin de l’ajuster à la zone visible de la page imprimée.


• Ne réduit pas la page pour l’ajuster à la zone visible de la page imprimée.


• Imprime chaque page comme une image.


• Imprime chaque page comme une page de texte.


• Imprime les pages dans l’ordre inverse.


• Imprime les pages dans l’ordre.


• Imprime toutes les annotations.


• N’imprime pas les annotations.

Renvoie

Vide

634


Application

635

Modèle Objet


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.


• Tous les scripts de calcul sont à nouveau exécutés.


• 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


Renvoie

637

Objet

Application

Modèle Objet


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


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


Renvoie

639

Vide

Application

Modèle Objet


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


Renvoie

641

Vide

Application

list, classe

Version

XFA 2.1

Exemples

JavaScript

xfa.record.nodes.remove(oNode);

FormCalc

xfa.record.nodes.remove(oNode)


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


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


Version

XFA 2.1

Exemples

JavaScript

Subform2.instanceManager.removeInstance(3);

FormCalc

Subform2.instanceManager.removeInstance(3)


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


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


Renvoie

645

Vide

Application

Modèle Objet


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


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


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


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)


• Masque la réponse de l’utilisateur avec des * (astérisques).


• 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


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


Renvoie

651

Valeur nulle

Application

Modèle Objet


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


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


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


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.


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


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


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


Version

XFA 2.1

Exemples

JavaScript

Subform1.instanceManager.setInstances(5);

FormCalc

Subform1.instanceManager.setInstances(5)


658


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


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.


• Supprime cet élément de la sélection actuelle.

Renvoie

Aucun

Application

Modèle Objet


Version

XFA 2.5

660


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


Renvoie

Entier à base zéro représentant le numéro de feuille.

Application

Modèle Objet


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


Version

XFA 2.5

5.1.106. sheetCountInBatch

Détermine le nombre de feuilles dans le lot actuel.

Syntaxe

Reference_Syntax.sheetCountInBatch( )

662


Version

663

2.5

Paramètres

Aucun

Renvoie

Un entier représentant la quantité de pages du lot actuel.

Application

Modèle Objet


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


Méthodes de script

Renvoie

Entier représentant le nombre de feuilles contenant l’objet de formulaire.

Application

Modèle Objet


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)


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


665

param5 (Facultatif)


Indique s’il est nécessaire ou non d’utiliser une boîte de dialogue pour autoriser un utilisateur à signer un formulaire.


• Indique qu’une boîte de dialogue est utilisée pour cette opération.


• 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)


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


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


Version

XFA 2.1

666


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


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)



• Indique qu’une boîte de dialogue est utilisée pour cette opération.


• Indique qu’une boîte de dialogue n’est pas utilisée pour cette opération.

param3(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


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


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


param2 (Facultatif)


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


Version

XFA 2.1

670


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


param2 (Facultatif)


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


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


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


param2 (Facultatif)


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


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


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


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


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


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


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.


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


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


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


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


• 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


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; }


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


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


lengthnodesrawValuevalue

appendclonecreateNodemessageBoxrecordremoveresolveNode


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


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


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);


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


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.


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


Utilisations

701


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).


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


multiLineoneOfChildrawValuevalue

record

702


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";


7.1.19. Calcul de totaux

Cet exemple explique comment calculer des totaux.

Utilisations


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


Utilisations

705


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; }


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


lengthnewTextnodesprevTextrawValuevalue

addItemclearItemsitemmessageBoxrecordresolveNode

706


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();


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


target exportData

708


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


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


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


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


rawValue messageBoxsaveXML


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


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

Guide de référence des scripts de Designer - helpx.adobe.com · A propos du guide de référence...

Documents

Transcript of Guide de référence des scripts de Designer - helpx.adobe.com · A propos du guide de référence...