THotPDF.FindStructureElementForMCID Method
Resuelve el diccionario StructElem que posee una secuencia de contenido marcado (página, MCID) dada, leyendo la clave /StructParents de la página e indexando el ParentTree del documento en tiempo constante
Declaration
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;Unit
HPDFDoc
Parameters and result
| Value | Purpose |
|---|---|
PageIndex | Zero-based page index whose marked content is being resolved |
MCID | Identificador de contenido marcado que se emite en la página y que AddStructureElement conecta al ParentTree |
| Result | El diccionario StructElem indirecto propietario, o nil cuando la página no está etiquetada, la ranura está vacía o alguno de los argumentos está fuera de rango |
Behavior
- Lee el entero
/StructParentsde la página y devuelve directamenteFParentTree[key][MCID], por lo que la búsqueda es independiente del número de elementos de estructura - Las referencias indirectas a StructElem se almacenan envueltas en un enlace dentro del ParentTree; el método resuelve el enlace hasta el diccionario de destino antes de devolverlo
- El método nunca lanza excepciones: una página sin etiquetar, un MCID sin asignar, una ranura marcadora
/nullo unos argumentos fuera de rango dan como resultadonil - El elemento devuelto es el mismo diccionario indirecto que produce
AddStructureElementy sirve como destino/SDdeAddStructureDestinationLink