1.1   添加评注 add

方法为：:

comment_id = obj.comments.add(body,
        author,
        action='comment',
        attachments=[],
        data=None,
        notify=True)

其中：

• body：评注的内容

• author：评注人多pid

• action: [可选]操作类型，默认是评注。

  可通过扩展其他类型的评注，比如圈阅。类似日志，对于扩展评注类型，使用渲染脚本名字作为action。

• attachments：[可选]附件对象的列表

• data：[可选]附加数据

• notify: 是否通知订阅人

返回添加的评注ID

1.2   删除评论 remove

obj.comments.remove(comment_id)

1.3   删除全部评论 clear

obj.comments.clear()

2.1   文档矩形标注

需要记录页面、位置等信息:

obj.comments.add(body, author,
    action="zopen.viewers:comment_doc_rect",
    data={"page": 2,
        "left_factor": 0.12,
        "top_factor": 0.12,
        "right_factor": 0.33,
        "bottom_factor": 0.33,
        })

2.2   文档点取标注

需要记录页面、位置等信息:

obj.comments.add(body, author,
    action="zopen.viewers:comment_doc_rect",
    data={"page": 2,
        "x_factor": 0.12,
        "y_factor": 0.12,
        })

2.3   图片点标注

需要记位置:

obj.comments.add(body, author,
    action="zopen.viewers:comment_image_point",
    data={
        "x_factor": 0.12,
        "y_factor": 0.12,
        })

2.4   图片区域标注

需要记位置:

obj.comments.add(body, author,
    action="zopen.viewers:comment_image_rect",
    data={
        "left_factor": 0.12,
        "top_factor": 0.12,
        "right_factor": 0.33,
        "bottom_factor": 0.33,
        })