AddCircleAnnotation

注释和热点链接

描述

添加内接于给定矩形的椭圆标记注释（PDF /Subtype /Circle），尽管名称如此，注释为完整椭圆，只有 Width 等于 Height 时才呈现为真圆，注释可选用实心内部颜色填充，颜色分量和不透明度使用 0–1 标度；Transparency 使用 0–100 标度（0 = 完全不透明，100 = 完全透明），由于此入口点发出 PDF 1.4 注释 /CA 不透明度键，库会在保存前将未锁定的较低版本文档提升至 PDF 1.4，锁定的较低目标将被兼容性门控拒绝，定义于 ISO 32000-1 §12.5.6.8

语法

Delphi

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

参数

左侧 — 当前单位中边界矩形左下角的水平坐标's

Top — 当前单位下边界矩形's 左下角的垂直坐标

Width — 边界矩形的宽度

高度 — 边界矩形的高度

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

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

Filled — 为 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 /Circle、/Rect、/C、/IC（Filled 时）、/BS、/Border、/CA、/F = 4（可打印）、/M、/CreationDate、/NM、/T、/Contents、/Subj = "Ellipse"、/P。这与 Adobe Acrobat 和 Foxit 的椭圆审阅工具生成的内容一致，因此外部审阅工作流可定位、编辑、评论并回复生成的注释

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