THotPDF.FindStructureElementForMCID-Methode
Löst das StructElem-Dictionary, das eine bestimmte Marked-Content-Sequenz (Seite, MCID) besitzt, indem der /StructParents-Schlüssel der Seite gelesen und in konstanter Zeit in den ParentTree des Dokuments indiziert wird
Deklaration
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;Einheit
HPDFDoc
Parameter und Ergebnis
| Wert | Zweck |
|---|---|
PageIndex | Nullbasierter Seitenindex, dessen Marked Content aufgelöst wird |
MCID | Marked-Content-Identifikator, der auf der Seite ausgegeben und von AddStructureElement in den ParentTree eingehängt wurde |
| Ergebnis | Das besitzende indirekte StructElem-Dictionary oder nil, wenn die Seite nicht getaggt ist, der Slot leer ist oder ein Argument außerhalb des Bereichs liegt |
Verhalten
- Liest die
/StructParents-Ganzzahl der Seite und liefert dann direktFParentTree[key][MCID], sodass die Suche unabhängig von der Zahl der Strukturelemente ist - Indirekte StructElem-Referenzen werden als verlinkter Eintrag im ParentTree gespeichert; die Methode löst den Link zum Ziel-Dictionary auf, bevor sie zurückkehrt
- Die Methode wirft nie: eine ungetaggte Seite, eine nicht allokierter MCID, ein
/null-Platzhalter-Slot oder Argumente außerhalb des Bereichs führen alle zunil - Das zurückgegebene Element ist dasselbe indirekte Dictionary, das
AddStructureElementerzeugt hat, und eignet sich als/SD-Ziel vonAddStructureDestinationLink