ReparentStructTreeCursor

Структурированный PDF, восстановление структуры

Описание

Переносит элемент-курсор под нового родителя или переупорядочивает его внутри того же родителя. Метод сначала нормализует дерево, проверяет достижимость обоих элементов, отвергает усыновление себя и циклы по потомкам, обновляет коллекцию потомков родителя и записывает соответствующую ссылку /P

Синтаксис

Delphi

Function TPDFlib.ReparentStructTreeCursor(CursorID, NewParentCursorID, ChildIndex: Integer): Integer;

ActiveX

Function PDFlib::ReparentStructTreeCursor(CursorID As Long, NewParentCursorID As Long, ChildIndex As Long) As Long

DLL

int DLReparentStructTreeCursor(int InstanceID, int CursorID, int NewParentCursorID, int ChildIndex);

Параметры

NewParentCursorIDКурсор элемента структуры либо 0 для корня дерева структуры
ChildIndexПозиция среди потомков структурного элемента с нумерацией от 1, или 0, чтобы добавить после существующих

Возвращаемые значения

Новый положительный индекс перемещённого элемента либо 0 при сбое валидации

Примечания

Целочисленные MCID, /MCR и /OBJR потомки сохраняют относительный порядок и не учитываются в ChildIndex. Перенос узла иерархии не меняет владение маркированным содержимым или значения parent-tree