AddLineAnnotation

注释和热点链接

描述

在所选页面上两个端点之间添加线条标记批注（PDF /Subtype /Line）。每个端点可带有不同的端线样式（箭头、方形、圆形、菱形、…），线体可用任意 RGB 颜色绘制并配置不透明度。具有内部区域的端部装饰（ClosedArrow、Square、Circle、Diamond）可选择填充。由于此入口点生成 PDF 1.4 批注 /CA 不透明度键，库会在保存前将较低且未锁定的文档提升至 PDF 1.4；锁定的较低目标会被兼容性门拒绝。定义于 ISO 32000-1 §12.5.6.7

语法

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

参数

StartLeft, StartTop — line's 起点端点在当前单位中的坐标

EndLeft、EndTop — 线条'的结束端点在当前单位中的坐标

BorderWidth — 当前单位中线条及其端部装饰的描边宽度

LineRed、LineGreen、LineBlue — 线条颜色的 RGB 分量（0–1），写入 /C

StartStyle、EndStyle — 分别用于起点和终点端点的线端样式，可使用以下之一：

0 = 无，1 = Square，2 = Circle，3 = Diamond，4 = OpenArrow，5 = ClosedArrow，6 = Butt，7 = ROpenArrow，8 = RClosedArrow，9 = Slash

超出范围的值会钳制为 0（None）

已填充 — 使用 1 为结束装饰发出内部填充颜色（/IC），使用 0 保持未填充

FillRed、FillGreen、FillBlue — 末端装饰内部填充颜色的 RGB 分量（0–1）。当 Filled 为 0 时忽略

标题 — 写入批注'的 /T 条目的作者姓名。传递空字符串可跳过

Contents — 与注释关联的弹出窗口正文，传递空字符串以跳过

透明度 — 以透明百分比表示的不透明度（0–100）。库会将其转换为 PDF /CA = 1 - Transparency/100，并限制在有效范围内

返回值

成功时为 1；未选择文档或无法创建注释时为 0

备注

注释 /Rect 会根据两个端点以及与边框宽度成比例的内边距自动计算，以便端点装饰保持在注释边界框内 PDF 阅读器要求边界 /Rect 包含整个可见绘图，否则端点装饰可能被裁剪

此入口点不会输出 PDF 规范描述的可选高级字段 — /LL（引导线长度）、/LLE、/LLO、/Cap、/CP、/CO 和 /Measure —。创建后可直接将其写入批注字典以追加这些字段

要在创建后覆盖线条颜色、边框、内容或矩形，请使用 SetAnnotBorderColor、SetAnnotBorderStyle、SetAnnotContents 和 SetAnnotRect