MergeDocumentEx
Manipulation de documents, formulaires
Description
Joint un autre document au document sélectionné tout en appliquant une stratégie explicite aux noms de champs de formulaire de premier niveau en double
Le contrôle préalable des noms en double s'achève avant toute modification des numéros d'objet, arborescences de pages ou tableaux de formulaires ; une source refusée reste ouverte et réutilisable
Syntaxe
Delphi
Function TPDFlib.MergeDocumentEx(DocumentID: Integer; DuplicateFieldStrategy: TPDFlibDuplicateFieldStrategy): Integer;Paramètres
| DocumentID | ID du document à ajouter au document sélectionné |
|---|---|
| DuplicateFieldStrategy | dfsReject, dfsMerge ou dfsAutoNumber |
Stratégies
| dfsReject | Rejette l'opération lorsqu'un nom de champ racine source existe déjà et laisse les deux documents inchangés |
|---|---|
| dfsMerge | Préserve le nom de champ partagé et applique la valeur cible et par défaut au champ importé, permettant aux lecteurs conformes de traiter les widgets comme un champ logique unique |
| dfsAutoNumber | Renomme chaque champ racine source en conflit avec le premier suffixe déterministe disponible, tel que _2 ou _3 |
Valeurs de retour
Renvoie 1 après une fusion réussie ou 0 si la validation ou la fusion échoue
Un doublon rejeté par dfsReject définit LastErrorCode sur 705
Remarques
Une fusion réussie supprime le document source de la collection de documents, conformément à MergeDocument
MergeDocument conserve son comportement hérité relatif aux champs en double pour assurer la compatibilité