AddPolyLineAnnotation

注释和热点链接

描述

向选定页面添加带提供顶点列表的开放多段线标记注释（PDF /Subtype /PolyLine）。多段线是开放的 — 阅读器不会将最后顶点连接回第一顶点 —，每个端点可有不同的末端线条样式。带内部的末端装饰（ClosedArrow、Square、Circle、Diamond）可选填充。颜色分量和不透明度按 0–1 范围表示；Transparency 按 0–100 范围给出（0 = 完全不透明，100 = 完全透明）。在较低最低版本锁定下生成 PolyLine 注释时，库会将文档版本提升到 PDF 1.5。定义于 ISO 32000-1 §12.5.6.9

语法

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

参数

VertexCoords — 顶点坐标，作为由空格、逗号、分号或制表符分隔的交替 x/y 值单个字符串。例如："100 100 200 150 300 100" 定义 V 形。至少需要两对（四个数字）且数字总数必须为偶数，否则调用返回 0

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 规范所述的可选高级字段 — /IT（意图，包括 PolyLineDimension）和 /Measure —。创建后可通过直接写入注释字典来附加它们

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