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 表示附加在既有 kids 之後

傳回值

被移動元素新的正數項目索引;驗證失敗時傳回 0

備註

整數 MCID、/MCR 與 /OBJR 子項保持相對順序,且不計入 ChildIndex。搬移階層節點不會改變 marked-content 的歸屬或 parent-tree 值