ComPDF
联系销售
文档DemoDownloadFAQ更新日志
Guides

全局配置 ​

GlobalConfig 控制应用级的全局行为，包括主题模式、文件保存策略、BOTA 面板、搜索高亮、缩略图、页面编辑器等。

配置字段总览 ​

字段类型默认值说明
themeModeString"system"应用主题模式
fileSaveExtraFontSubsetbooleantrue保存时是否嵌入字体子集
useSaveIncrementalbooleantrue是否使用增量保存
signatureTypeString"manual"默认签名类型
enableExitSaveTipsbooleantrue退出时是否显示保存提示
enableErrorTipsbooleantrue是否显示错误提示

主题模式 ​

themeMode 控制应用的整体主题：

值说明
light浅色模式
dark深色模式
system跟随系统（默认）
json
{
  "global": {
    "themeMode": "system"
  }
}

themeMode 控制的是应用 UI 框架主题（状态栏、工具栏背景等），与 readerViewConfig.themes 控制的 PDF 页面阅读主题不同。参见 主题与样式 了解两者区别。

保存行为 ​

json
{
  "global": {
    "fileSaveExtraFontSubset": true,
    "useSaveIncremental": true,
    "enableExitSaveTips": true
  }
}
字段说明
fileSaveExtraFontSubset保存时嵌入字体子集，确保编辑过的文本在其他设备上正确显示
useSaveIncremental增量保存仅追加变更数据到文件末尾，速度快但文件可能逐渐增大
enableExitSaveTips退出文档时若有未保存更改，弹出保存提示对话框

签名类型 ​

json
{
  "global": {
    "signatureType": "manual"
  }
}
值说明
manual手写签名（默认）
digital数字签名
electronic电子签名

水印配置 ​

global.watermark 配置水印对话框的默认值：

json
{
  "global": {
    "watermark": {
      "types": ["text", "image"],
      "saveAsNewFile": false,
      "text": "",
      "image": "tools_logo",
      "textSize": 80,
      "textColor": "#FF000000",
      "scale": 1.0,
      "rotation": -45,
      "opacity": 255,
      "isFront": false,
      "isTilePage": false
    }
  }
}
字段说明
types可用水印类型：text（文本）、image（图片）
saveAsNewFile是否保存为新文件
text默认文本内容
image默认图片资源名（drawable 中的资源）
textSize文本字号
textColor文本颜色
scale缩放比例
rotation旋转角度
opacity不透明度（0-255）
isFront是否在页面前景（true）或背景（false）
isTilePage是否平铺到整个页面

缩略图配置 ​

json
{
  "global": {
    "thumbnail": {
      "title": "",
      "backgroundColor": "",
      "editMode": true
    }
  }
}
字段说明
title缩略图面板标题
backgroundColor背景颜色
editMode是否启用缩略图编辑模式（支持页面拖拽排序、删除等）

BOTA 面板配置 ​

BOTA（Book Of Annotations）面板包含大纲、书签和注释列表三个标签页。

json
{
  "global": {
    "bota": {
      "tabs": ["outline", "bookmark", "annotations"],
      "menus": {
        "annotations": {
          "global": [
            { "id": "importAnnotation" },
            { "id": "exportAnnotation" },
            { "id": "removeAllAnnotation" },
            { "id": "removeAllReply" }
          ],
          "item": [
            {
              "id": "reviewStatus",
              "subMenus": ["accepted", "rejected", "cancelled", "completed", "none"]
            },
            { "id": "markedStatus" },
            {
              "id": "more",
              "subMenus": ["addReply", "viewReply", "delete"]
            }
          ]
        }
      }
    }
  }
}

BOTA 标签页 ​

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

注释列表菜单 ​

全局菜单（global）：作用于整个注释列表的操作。

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

条目菜单（item）：作用于单个注释条目的操作。

id说明
reviewStatus审核状态（子菜单：accepted/rejected/cancelled/completed/none）
markedStatus标记状态
more更多操作（子菜单：addReply/viewReply/delete）

搜索高亮配置 ​

json
{
  "global": {
    "search": {
      "normalKeyword": {
        "borderColor": "#00000000",
        "fillColor": "#77FFFF00"
      },
      "focusKeyword": {
        "borderColor": "#00000000",
        "fillColor": "#CCFD7338"
      }
    }
  }
}
字段说明
normalKeyword普通搜索结果的高亮样式（边框色 + 填充色）
focusKeyword当前聚焦的搜索结果高亮样式

页面编辑器配置 ​

json
{
  "global": {
    "pageEditor": {
      "menus": [
        "insertPage",
        "replacePage",
        "extractPage",
        "copyPage",
        "rotatePage",
        "deletePage"
      ]
    }
  }
}
菜单项说明
insertPage插入页面
replacePage替换页面
extractPage提取页面
copyPage复制页面
rotatePage旋转页面
deletePage删除页面