THotPDF.FindStructureElementForMCID Method
Разрешает dictionary StructElem, владеющий заданной marked-content последовательностью (страница, MCID): метод читает ключ /StructParents страницы и за константное время индексируется в ParentTree документа
Объявление
function FindStructureElementForMCID(PageIndex, MCID: Integer): THPDFDictionaryObject;Модуль
HPDFDoc
Параметры и результат
| Значение | Назначение |
|---|---|
PageIndex | Индекс страницы (с нуля), marked content которой разрешается |
MCID | Идентификатор marked-content, проставленный на странице и связанный с ParentTree методом AddStructureElement |
| Result | Владеющий indirect dictionary StructElem или nil, когда страница не tagged, слот пуст или любой аргумент вне диапазона |
Поведение
- Читает целое
/StructParentsсо страницы и сразу возвращаетFParentTree[key][MCID], поэтому поиск не зависит от количества structure elements - Indirect ссылки на StructElem хранятся в ParentTree завёрнутыми в link; метод разрешает link в целевой dictionary перед возвратом
- Метод никогда не бросает исключений: нетегированная страница, незанятый MCID, placeholder-слот
/nullили аргументы вне диапазона — всё сводится кnil - Возвращаемый элемент — тот же indirect dict, что создаёт
AddStructureElement, и он подходит как цель/SDдляAddStructureDestinationLink