Guides

注释列表（BOTA）

BOTA（Book of Annotations）面板提供大纲、书签和注释列表三个标签页。注释列表展示文档中所有注释的摘要信息，支持浏览、定位、回复和批量操作。

BOTA 标签页配置

通过 global.bota.tabs 控制 BOTA 面板中显示的标签页：

{
  "global": {
    "bota": {
      "tabs": ["outline", "bookmark", "annotations"]
    }
  }
}

值	说明
outline	文档大纲 / 目录
bookmark	书签
annotations	注释列表

如果只需注释列表：

{
  "global": {
    "bota": {
      "tabs": ["annotations"]
    }
  }
}

注释列表菜单配置

通过 global.bota.menus.annotations 配置注释列表的菜单项。

全局菜单

全局菜单位于注释列表顶部，作用于整个列表：

{
  "global": {
    "bota": {
      "menus": {
        "annotations": {
          "global": [
            { "id": "importAnnotation" },
            { "id": "exportAnnotation" },
            { "id": "removeAllAnnotation" },
            { "id": "removeAllReply" }
          ]
        }
      }
    }
  }
}

id	说明
importAnnotation	导入 XFDF 格式注释
exportAnnotation	导出注释为 XFDF 格式
removeAllAnnotation	删除所有注释
removeAllReply	删除所有注释回复

条目菜单

条目菜单作用于单个注释项，长按注释条目时显示：

{
  "global": {
    "bota": {
      "menus": {
        "annotations": {
          "item": [
            {
              "id": "reviewStatus",
              "subMenus": ["accepted", "rejected", "cancelled", "completed", "none"]
            },
            { "id": "markedStatus" },
            {
              "id": "more",
              "subMenus": ["addReply", "viewReply", "delete"]
            }
          ]
        }
      }
    }
  }
}

id	说明
reviewStatus	审核状态，含子菜单：accepted（已通过）、rejected（已拒绝）、cancelled（已取消）、completed（已完成）、none（无状态）
markedStatus	标记状态切换
more	更多操作，含子菜单：addReply（添加回复）、viewReply（查看回复）、delete（删除注释）

核心组件

CPDFAnnotationListFragment

注释列表的主 Fragment，位于 com.compdfkit.tools.annotation.pdfannotationlist 包中。

功能包括：

• 按页码分组展示所有注释
• 显示注释类型图标、内容摘要、作者和时间
• 点击注释条目可定位到文档中对应位置
• 支持审核状态和标记状态的设置

注释回复

注释列表支持对注释添加和查看回复：

组件	说明
CPDFEditReplyDialogFragment	编辑回复内容的对话框
CPDFReplyDetailsDialogFragment	查看回复详情的对话框
CPDFAnnotReplyListAdapter	回复列表适配器
CMarkedTipsWindow	标记状态提示窗口

BOTA 面板组件

组件	说明
CPDFBotaDialogFragment	BOTA 面板对话框
CPDFBotaFragmentTabs	标签页容器
CPDFBookmarkFragment	书签列表（viewer 包）
CPDFOutlineFragment	大纲/目录列表（viewer 包）