THotPDF.FindStructureElementForMCID Méthode
Résout le dictionnaire StructElem propriétaire d’une séquence de marked-content (page, MCID) donnée en lisant la clé /StructParents de la page et en indexant le ParentTree du document en temps constant
Déclaration
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;
Unité
HPDFDoc
Paramètres et résultat
| Valeur | Rôle |
|---|---|
PageIndex | Index de page à partir de zéro dont on résout le marked content |
MCID | Identifiant de marked-content émis sur la page et relié au ParentTree par AddStructureElement |
| Résultat | Le dictionnaire StructElem indirect propriétaire, ou nil quand la page n’est pas balisée, que l’emplacement est vide ou qu’un argument est hors plage |
Comportement
- Lit l’entier
/StructParentsde la page, puis renvoie directementFParentTree[key][MCID], de sorte que la recherche est indépendante du nombre d’éléments de structure - Les références StructElem indirectes sont stockées enveloppées dans un lien à l’intérieur du ParentTree ; la méthode résout le lien vers le dictionnaire cible avant de renvoyer
- La méthode ne lève jamais d’exception : une page non balisée, un MCID non alloué, un emplacement placeholder
/nullou des arguments hors plage se réduisent tous ànil - L’élément renvoyé est le même dictionnaire indirect produit par
AddStructureElementet convient comme cible/SDdeAddStructureDestinationLink