ReparentStructTreeCursor

Tagged PDF, Strukturreparatur

Beschreibung

Verschiebt das Cursorelement unter ein neues übergeordnetes Element oder ordnet es innerhalb desselben übergeordneten Elements neu. Die Methode normalisiert zuerst den Baum, prüft die Erreichbarkeit beider Elemente, weist Selbstzuordnung und Nachfolgerzyklen ab, aktualisiert die Sammlung untergeordneter Elemente und schreibt den passenden untergeordneten /P-Verweis

Syntax

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);

Parameter

NewParentCursorIDEin Strukturelementcursor oder 0 für den Stamm des Strukturbaums
ChildIndexEinsbasierte Position unter den untergeordneten Strukturelementen oder 0 zum Anfügen hinter vorhandenen untergeordneten Elementen

Rückgabewerte

Der neue positive Elementindex des verschobenen Elements oder 0, wenn die Validierung fehlschlägt

Anmerkungen

Ganzzahlige MCIDs sowie untergeordnete Elemente vom Typ /MCR und /OBJR behalten ihre relative Reihenfolge und werden von ChildIndex nicht mitgezählt. Das Verschieben eines Hierarchieknotens ändert weder die Eigentümerschaft markierter Inhalte noch Werte des übergeordneten Baums