Modèle d'objet
Les règles applicables aux modèles d'objets utilisés sont décrites ci-dessous.
Travailler avec des ensembles
Tous les ensembles du modèle d'objet prennent en charge les méthodes suivantes :
| Nom | Type | Accès | Description |
|---|---|---|---|
| Count | int | Lecture seule | Le nombre d'éléments de l'ensemble |
| Item( index : int ) | ItemInterface | Lecture seule |
Récupère un élément de l'ensemble grâce à l'index spécifié. L'énumération commence par « 0 ». |
Remarque : Au lieu d'utiliser la méthode Item, vous pouvez également traiter les éléments de l'ensemble en utilisant des parenthèses ou des crochets. Cela dépend du langage sélectionné. Les parenthèses sont utilisées dans les langages JScript, VBScript et Visual Basic.Net languages, parentheses are used. En C#.Net, seuls les crochets peuvent être utilisés. En JScript.Net, les parenthèses et les crochets peuvent tous deux être utilisés.
Par exemple,
Items( 1 ).Text = "Hello" or Items[ 1 ].Text = "Hello"
Tous les ensembles peuvent être utilisés dans "for each" et dans les constructions similaires.
Travailler avec des champs récurrents et des tableaux
Tous les champs de documents, excepté les tableaux, peuvent être récurrents.
Dans la structure de document, les champs récurrents sont représentés par un champ prototype spécial qui dispose d'un ensemble non vide Items.
Un champ prototype ne dispose ni d'éléments enfants ni de valeurs. Il n'est utilisé que pour stocker l'ensemble des itérations de champs. Les champs Enfants et/ou les valeurs de champs ne peuvent être attribués qu'aux exemples de champs, qui sont disponibles via la méthode Items de l'obje IField.
Les tableaux comportent toujours l'ensemble Rows (Rows est synonyme d'Items). L'ensemble Rows ne contient que les lignes du tableau dont les cellules sont accessibles via la méthode Children des lignes de l'objet.
Composition des chemins d'accès des champs
Les méthodes Field, HasField et IndexedItemValue de l'objet IDocument utilisent les chemins d'accès des champs sous la forme de paramètres. Voici la méthode formelle permettant de représenter le chemin d'accès avec un BNF (Formulaire de Backus-Naur) :
<Path> ::= <Path_component> | <Path> "\" <Path_component>
<Path_component> ::= <Field_name> | <Field_name> "["<Field_iteration_number>"]"
Ici, Field_name indique les noms des champs de documents tels qu'ils sont définis dans la définition de document et Field_iteration_number représente le nombre d'itérations de champs récurrents (le nombre de lignes des tableaux commençant par « 0 ».
Le chemin d'accès peut être complet ou relatif. Les chemins d'accès complets sont constitués en commençant par le nom de la section de document, alors que les chemins d'accès relatifs sont constitués en commençant par le nom de l'élément enfant du groupe.
Par exemple, pour traiter la troisième ligne de la colonne « Total » du tableau « Table », qui se situe dans la section « Section », vous devez écrire ce qui suit :
"Section\Table[2]\Total"
Ce nom complet peut être créé via la méthode FullName de l'objet IField.
12.04.2024 18:16:04