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 名称标记,用于从根到每个叶节点标记连续的层级
RecordLevel作为可变数据记录处理的从零开始层级,或 -1 以省略 /RecordLevel

返回值

成功时返回正的根部件标识符,失败时返回 0,并且 LastErrorCode 为 122 或 525

备注

文档将提升到 PDF 2.0,且必须已至少包含一页

调用 AddDocumentPart 创建后代节点,或调用 SetDocumentPartPageRange 使根节点成为单级层次结构中的叶节点

创建新层级会移除任何现有层级的页面链接和目录链接

另请参阅

ValidateDocumentPartHierarchy,ClearDocumentPartHierarchy