Guides

注释属性设置

通过 annotationsConfig.initAttribute 可设置各注释类型的默认属性。创建新注释时将自动应用这些属性。

便签注释（Note）

{
  "annotationsConfig": {
    "initAttribute": {
      "note": {
        "color": "#1460F3",
        "alpha": 255
      }
    }
  }
}

字段	说明
color	图标颜色（十六进制）
alpha	不透明度（0-255）

标注注释（Markup）

包括高亮（highlight）、下划线（underline）、波浪线（squiggly）和删除线（strikeout），共享相同的属性结构：

{
  "annotationsConfig": {
    "initAttribute": {
      "highlight": {
        "color": "#1460F3",
        "alpha": 77
      },
      "underline": {
        "color": "#1460F3",
        "alpha": 77
      },
      "squiggly": {
        "color": "#1460F3",
        "alpha": 77
      },
      "strikeout": {
        "color": "#1460F3",
        "alpha": 77
      }
    }
  }
}

字段	说明
color	标注颜色
alpha	不透明度（0-255）

手写注释（Ink）

{
  "annotationsConfig": {
    "initAttribute": {
      "ink": {
        "color": "#1460F3",
        "alpha": 100,
        "borderWidth": 10
      }
    }
  }
}

字段	说明
color	画笔颜色
alpha	不透明度（0-255）
borderWidth	画笔线宽

形状注释（Shape）

矩形（Square）和圆形（Circle）

{
  "annotationsConfig": {
    "initAttribute": {
      "square": {
        "fillColor": "#1460F3",
        "borderColor": "#000000",
        "colorAlpha": 128,
        "borderWidth": 2,
        "borderStyle": {
          "style": "solid",
          "dashGap": 0.0
        },
        "bordEffectType": "solid"
      },
      "circle": {
        "fillColor": "#1460F3",
        "borderColor": "#000000",
        "colorAlpha": 128,
        "borderWidth": 2,
        "borderStyle": {
          "style": "solid",
          "dashGap": 0.0
        },
        "bordEffectType": "solid"
      }
    }
  }
}

字段	说明
fillColor	填充颜色
borderColor	边框颜色
colorAlpha	不透明度（0-255）
borderWidth	边框宽度
borderStyle.style	边框样式："solid"（实线）或 "dashed"（虚线）
borderStyle.dashGap	虚线间隔
bordEffectType	边框效果类型："solid"（普通）或 "cloudy"（云朵）

直线（Line）

{
  "annotationsConfig": {
    "initAttribute": {
      "line": {
        "borderColor": "#1460F3",
        "borderAlpha": 100,
        "borderWidth": 5,
        "borderStyle": {
          "style": "solid",
          "dashGap": 0.0
        }
      }
    }
  }
}

箭头（Arrow）

{
  "annotationsConfig": {
    "initAttribute": {
      "arrow": {
        "borderColor": "#1460F3",
        "borderAlpha": 100,
        "borderWidth": 5,
        "borderStyle": {
          "style": "solid",
          "dashGap": 0.0
        },
        "startLineType": "none",
        "tailLineType": "openArrow"
      }
    }
  }
}

字段	说明
startLineType	起点端点样式
tailLineType	终点端点样式

端点样式值：none、openArrow、closedArrow、square、circle、diamond、butt、ropenArrow、rclosedArrow、slash。

文本框注释（FreeText）

{
  "annotationsConfig": {
    "initAttribute": {
      "freeText": {
        "fontColor": "#000000",
        "fontColorAlpha": 255,
        "fontSize": 30,
        "alignment": "left",
        "familyName": "Helvetica",
        "styleName": "Regular"
      }
    }
  }
}

字段	说明
fontColor	文字颜色
fontColorAlpha	文字不透明度（0-255）
fontSize	字号
alignment	对齐方式："left"、"center"、"right"
familyName	字体名称（详见字体管理）
styleName	字体样式，如 "Regular"、"Bold"、"Italic"

属性编辑 Fragment

每种注释类型都有对应的属性编辑 Fragment，用于在 UI 中编辑注释样式：

注释类型	Fragment 类
Markup	CMarkupStyleFragment
Note	CNoteStyleFragment
Ink	CInkStyleFragment
FreeText	CFreeTextStyleFragment
Shape	CShapeStyleFragment
Stamp	CStampStyleFragment
Signature	CSignatureStyleFragment
Image	CImageStyleFragment

在源码集成模式下，可继承或修改这些 Fragment 以自定义属性面板 UI。