Mark

PDF 文档标记操作对象，通过 Application.ActivePDF.Mark 访问。

方法

rectHand

进入区域标记模式。调用后，用户可在页面上拖拽框选区域，框选完成后触发 PDF.Event.MarkAreaCreated 事件。

语法

Application.ActivePDF.Mark.rectHand()

返回值

Promise<boolean>

示例

async function example() {
  const success = await Application.ActivePDF.Mark.rectHand();
}

addComment

为指定批注添加文本评论。

语法

Application.ActivePDF.Mark.addComment(id, text, style)

参数

属性	数据类型	必填	说明
id	string	是	批注 ID
text	string	是	评论文本
style	Object	是	文本样式

style 的属性	数据类型	必填	说明
fontSize	number	是	字号，单位 pt
fontColor	string	是	字体颜色，十六进制颜色值，形如 `#000000`
fontName	string	是	字体名称

返回值

Promise<boolean>

示例

async function example() {
  const success = await Application.ActivePDF.Mark.addComment(
    "annotation-id",
    "这是一条评论",
    {
      fontSize: 12,
      fontColor: "#000000",
      fontName: "宋体",
    }
  );
}

addBlackout

JSSDK: 1.11.0、zOffice V8.3 支持

在指定页面添加区域涂黑。调用后在给定位置创建涂黑区域，涂黑处于未嵌入状态，需通过界面操作或后续接口使其生效。

语法

Application.ActivePDF.Mark.addBlackout(page, x, y, width, height)

参数

属性	数据类型	必填	说明
page	number	是	页码，从 1 开始
x	number	是	涂黑区域起始位置 x 坐标（页面视口坐标）
y	number	是	涂黑区域起始位置 y 坐标（页面视口坐标）
width	number	是	涂黑区域宽度
height	number	是	涂黑区域高度

坐标说明：x、y、width、height 使用页面视口坐标系，与 PDF 页面渲染坐标一致，不受浏览器窗口缩放影响。

返回值

Promise<boolean>

示例

async function example() {
  // 在第 1 页坐标 (100, 200) 处添加宽 150、高 30 的涂黑区域
  const success = await Application.ActivePDF.Mark.addBlackout(1, 100, 200, 150, 30);
}

Mark​

方法​

rectHand​

addComment​

addBlackout​

Mark

方法

rectHand

addComment

addBlackout