Método THotPDF.FindStructureElementForMCID
Resuelve el diccionario StructElem que posee una secuencia de marked-content (página, MCID) dada, leyendo la clave /StructParents de la página e indexando en el ParentTree del documento en tiempo constante
Declaración
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;Unidad
HPDFDoc
Parámetros y resultado
| Valor | Propósito |
|---|---|
PageIndex | Índice de página zero-based cuyo marked content se está resolviendo |
MCID | Identificador de marked-content emitido en la página y conectado al ParentTree por AddStructureElement |
| Result | El diccionario StructElem indirecto propietario, o nil cuando la página no está tagged, el slot está vacío o alguno de los argumentos queda fuera de rango |
Comportamiento
- Lee el entero
/StructParentsde la página y luego devuelveFParentTree[key][MCID]directamente, de modo que la búsqueda es independiente de la cantidad de elementos de estructura - Las referencias indirectas a StructElem se guardan envueltas en un link dentro del ParentTree; el método resuelve el link hacia el diccionario de destino antes de devolver
- El método nunca lanza excepciones: una página sin tag, un MCID no asignado, un slot con placeholder
/nullo argumentos fuera de rango colapsan todos ennil - El elemento devuelto es el mismo dict indirecto producido por
AddStructureElementy sirve como destino/SDdeAddStructureDestinationLink