BeginDocumentPartHierarchy

文件部分、可變資料、PDF 2.0

描述

取代所選文件的文件部分階層,並傳回根部分識別碼

語法

Delphi

Function TPDFlib.BeginDocumentPartHierarchy(Const NodeNames: WideString; RecordLevel: Integer): Integer;

DLL

int DLBeginDocumentPartHierarchy(int InstanceID, const wchar_t* NodeNames, int RecordLevel);

ActiveX

Function PDFlib::BeginDocumentPartHierarchy(NodeNames As String, RecordLevel As Long) As Long

參數

NodeNames以分號分隔的 XML 名稱 token,標示從根到每個葉的逐層階層
RecordLevel視為可變資料記錄的層級(零起算);-1 表示省略 /RecordLevel

傳回值

成功傳回正數的根部分識別碼;失敗則傳回 0,並透過 LastErrorCode 回報 122 或 525

備註

文件會提升至 PDF 2.0,且必須已包含至少一頁

請呼叫 AddDocumentPart 建立子節點,或呼叫 SetDocumentPartPageRange 讓根節點在單層階層中成為葉節點

建立新階層會移除既有階層的頁面連結與目錄連結

另見

ValidateDocumentPartHierarchy, ClearDocumentPartHierarchy