AddPolygonAnnotation

注释和热点链接

描述

将带有闭合顶点列表的闭合多边形标记注释（PDF /Subtype /Polygon）添加到所选页面，多边形会隐式闭合 — 阅读器渲染时会将最后一个顶点连接回第一个顶点，该形状可选用纯色内部颜色填充，颜色分量和不透明度以 0–1 标度表示，透明度 使用 0–100 标度（0 = 完全不透明，100 = 完全透明），在较低的最低版本锁定下输出 Polygon 注释时，库会将文档版本提升至 PDF 1.5，定义于 ISO 32000-1 §12.5.6.9

语法

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

参数

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

BorderWidth — 多边形轮廓的描边宽度，以当前单位计

BorderRed、BorderGreen、BorderBlue — 写入 /C 的轮廓颜色 RGB 分量（0–1）

已填充 — 1 为多边形主体输出内部填充色（/IC），0 保持未填充

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

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

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

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

返回值

成功时返回 1；未选择文档、顶点字符串无法解析或无法创建注释时返回 0

备注

注释 /Rect 会根据顶点范围自动计算，并加上与边框宽度成比例的小边距，使轮廓描边保持在注释边界框内

此入口点不会输出 PDF 规范描述的可选高级字段 — /BE（边框效果，包括云状轮廓样式）、/IT（意图，包括 PolygonCloud 和 PolygonDimension）及 /Measure —。创建后可直接将这些字段写入注释字典来追加

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