THotPDF.FindStructureElementForMCID Method
Resolve o dicionário StructElem que possui uma determinada sequência de conteúdo marcado (página, MCID) lendo a chave /StructParents da página e indexando no ParentTree do documento em tempo constante
Declaração
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;
Unidade
HPDFDoc
Parâmetros e resultado
| Valor | Finalidade |
|---|---|
PageIndex | Índice de página baseado em zero cujo conteúdo marcado está sendo resolvido |
MCID | Identificador de conteúdo marcado emitido na página e conectado ao ParentTree por AddStructureElement |
| Resultado | O dicionário StructElem indireto proprietário, ou nil quando a página não é marcada, o slot está vazio ou qualquer argumento está fora do intervalo |
Comportamento
- Lê o inteiro
/StructParentsda página e depois retornaFParentTree[key][MCID]diretamente, de modo que a consulta é independente do número de elementos de estrutura - As referências indiretas StructElem são armazenadas envoltas em um link dentro do ParentTree; o método resolve o link para o dicionário de destino antes de retornar
- O método nunca gera exceção: uma página não marcada, um MCID não alocado, um slot de espaço reservado
/nullou argumentos fora do intervalo colapsam todos paranil - O elemento retornado é o mesmo dicionário indireto produzido por
AddStructureElemente é adequado como destino/SDdeAddStructureDestinationLink