AddSquareAnnotation

注释和热点链接

描述

向选定页面添加矩形标记注释（PDF /Subtype /Square）。该注释在给定边界矩形内绘制描边矩形，并可选择填充纯色内部。颜色分量和不透明度采用 0–1 标度；Transparency 采用 0–100 标度（0 = 完全不透明，100 = 完全透明）。由于该入口点输出 PDF 1.4 注释 /CA 不透明度键，库会在保存前将较低版本的未锁定文档提升至 PDF 1.4；兼容性门会拒绝锁定的较低目标版本。定义见 ISO 32000-1 §12.5.6.8

语法

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

参数

Left — 当前单位中注释矩形's左下角的水平坐标

顶部 — 注释矩形'左下角的垂直坐标，使用当前单位

此项说明适用于相应的 PDF 文档操作和 API 行为—

高度 — 注释矩形的高度

BorderWidth — 矩形边框的描边宽度，采用当前单位。会同时写入 /Border 旧版字段和 /BS 边框样式字典

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

备注

该注释以一组标准标记字段输出：/Type /Annot、/Subtype /Square、/Rect、/C、/IC（Filled 时）、/BS、/Border、/CA、/F = 4（可打印）、/M、/CreationDate、/NM、/T、/Contents、/Subj = "Rectangle"、/P。这与 Adobe Acrobat 和 Foxit 的矩形审阅工具所生成的内容一致，因此外部审阅工作流可以定位、编辑、评论及回复生成的注释

创建后如需覆盖注释矩形、颜色、内容或边框，请使用 SetAnnotRect、SetAnnotBorderColor、SetAnnotContents 和 SetAnnotBorderStyle