AddArticleThread

页面级导航、文档属性

描述

创建一个 PDF 文档文章线索，其珠节点定义跨一个或多个页面矩形的逻辑阅读顺序

该方法会按照 ISO 32000-1 §12.4.3 的要求写入目录 /Threads 数组、线程 /F 条目、环形 /N 和 /V 珠链、页面引用、矩形以及每页的 /B 数组

语法

Function TPDFlib.AddArticleThread(Const Info: TPDFlibArticleThreadInfo; Const Beads: Array Of TPDFlibArticleBead): Integer;

参数

Info	可选的标题、作者、主题、关键字和 PDF 创建日期元数据；写入时会忽略 `BeadCount`
Beads	文章阅读顺序中的一个或多个页面矩形

返回值

返回新的从 1 开始的文章线程索引；文档、页码、矩形或现有文章容器无效时返回 0

备注

每个矩形使用未缩放的 PDF 用户空间坐标，顺序为左、下、右、上

在添加对象前验证输入，重复页面复用稳定的页面引用，并保留所选页面

DeletePages 移除空线程并修复存续线程的循环链接

示例

Info.Title := 'Feature story';
Info.Author := 'Editorial desk';
SetLength(Beads, 2);
Beads[0].Page := 1;
Beads[0].Left := 72;
Beads[0].Bottom := 360;
Beads[0].Right := 288;
Beads[0].Top := 720;
Beads[1].Page := 3;
Beads[1].Left := 72;
Beads[1].Bottom := 360;
Beads[1].Right := 288;
Beads[1].Top := 720;
ThreadIndex := PDF.AddArticleThread(Info, Beads);

另请参阅

AddLinkToArticleThread、SetOutlineArticleThread、ArticleThreadCount、GetArticleThreadInfo、GetArticleThreadBead、TPDFlibArticleThreadInfo、TPDFlibArticleBead