feat(电子公文): 完善标引注释，优化资源处理

ofdgo_structure_object.go

@@ -14,28 +14,47 @@
 
 package ofdgo
 
-// structureObjectVisitor 收集页面及复合图元标识，绑定校验不解码字体、图片或裁剪
+import "context"
+
+// structureObjectVisitor 收集页面、复合图元及注释外观标识，绑定校验不解码字体、图片或裁剪
 type structureObjectVisitor struct {
-	objects map[string]bool
-	targets []StructureTarget
+	objects     map[string]bool
+	targets     []StructureTarget
+	listTargets bool
 }
 
-// StructureObjects 列出指定页可绑定的图元及原文，包含模板、隐藏内容和复合图元成员
+// StructureObjects 列出指定页可绑定的图元及原文，包含模板、隐藏内容、复合图元成员和注释外观
 // 不解码字体和图片，返回顺序遵循页面遍历顺序，同一标识仅列出一次
 // 入参: page 从0开始的页面索引
 // 返回: []StructureTarget 候选图元，不计算Bounds, error 页面或遍历错误
 func (r *Renderer) StructureObjects(page int) ([]StructureTarget, error) {
-	content, err := r.Reader.PageContentByIndex(page)
+	return r.StructureObjectsContext(context.Background(), page)
+}
+
+// StructureObjectsContext 列出页面绑定候选，读取或遍历取消时不返回部分结果，不改变渲染选项
+// 入参: ctx 取消上下文, page 从0开始的页面索引
+// 返回: []StructureTarget 候选图元，不计算Bounds, error 页面读取、遍历或取消错误
+func (r *Renderer) StructureObjectsContext(ctx context.Context, page int) ([]StructureTarget, error) {
+	content, err := r.Reader.PageContentByIndexContext(ctx, page)
 	if err != nil {
 		return nil, err
 	}
-	visitor := &structureObjectVisitor{objects: make(map[string]bool)}
-	if err := r.WalkPage(content, visitor); err != nil {
+	visitor := &structureObjectVisitor{objects: make(map[string]bool), listTargets: true}
+	view := *r
+	view.RenderAnnotations = true
+	view.pageContext = ctx
+	if err := view.WalkPage(content, visitor); err != nil {
 		return nil, err
 	}
 	for i := range visitor.targets {
+		if err := ctx.Err(); err != nil {
+			return nil, err
+		}
 		visitor.targets[i].Page, visitor.targets[i].PageID = page+1, content.ID
 	}
+	if err := ctx.Err(); err != nil {
+		return nil, err
+	}
 	return visitor.targets, nil
 }
 
@@ -46,6 +65,9 @@ func (v *structureObjectVisitor) BeginObject(object *GraphicObject) bool {
 	id := editorResourceID(editorObjectID(*object))
 	if id != "" && !v.objects[id] {
 		v.objects[id] = true
+		if !v.listTargets {
+			return false
+		}
 		target := StructureTarget{ID: id}
 		if object.Type == "TextObject" {
 			target.Text = object.TextObject.Text()
@@ -58,7 +80,7 @@ func (v *structureObjectVisitor) BeginObject(object *GraphicObject) bool {
 // EndObject 满足分组访问接口，不维护分组栈
 func (v *structureObjectVisitor) EndObject() {}
 
-// BeginAnnotation 不为注解容器分配正文图元标识
+// BeginAnnotation 不将注释容器编号作为图元标识
 // 入参: id 注解标识
 // 返回: bool 始终为false
 func (v *structureObjectVisitor) BeginAnnotation(id string) bool { return false }