THotPDF.FindStructureElementForMCID Method
Risolve il dizionario StructElem che possiede una data sequenza di marked-content (pagina, MCID) leggendo la chiave /StructParents della pagina e indicizzando nella ParentTree del documento in tempo costante
Dichiarazione
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;
Unità
HPDFDoc
Parametri e risultato
| Valore | Scopo |
|---|---|
PageIndex | Indice di pagina a base zero di cui si sta risolvendo il marked content |
MCID | Identificatore di marked-content emesso sulla pagina e collegato nella ParentTree da AddStructureElement |
| Result | Il dizionario StructElem indiretto proprietario, oppure nil quando la pagina non è taggata, lo slot è vuoto o un argomento è fuori intervallo |
Comportamento
- Legge l'intero
/StructParentsdella pagina, poi restituisce direttamenteFParentTree[key][MCID], così la lookup è indipendente dal numero di elementi di struttura - I riferimenti indiretti a StructElem sono memorizzati avvolti in un link all'interno della ParentTree; il metodo risolve il link verso il dizionario di destinazione prima di restituire
- Il metodo non solleva mai eccezioni: una pagina non taggata, un MCID non allocato, uno slot segnaposto
/nullo argomenti fuori intervallo collassano tutti anil - L'elemento restituito è lo stesso dict indiretto prodotto da
AddStructureElemented è adatto come destinazione/SDdiAddStructureDestinationLink