Flutter Guides Creation policy

注释与表单创建策略

ComPDF Flutter SDK 自 3.2.0 起支持通过 CPDFCreationConfig 统一配置交互创建结束后的行为。

import 'package:compdfkit_flutter/configuration/cpdf_configuration.dart';

设置创建策略

创建阅读器时，将配置传入 CPDFConfiguration.creationConfig：

final configuration = CPDFConfiguration(
  creationConfig: const CPDFCreationConfig(
    continuousCreation: false,
    autoSelectCreatedAnnotation: true,
  ),
);

将 configuration 传给 CPDFReaderWidget 的 configuration 参数。上述配置用于创建一个对象后退出当前创建工具，并选中新建对象。

参数	默认值	说明
continuousCreation	true	创建完成后保持当前工具，可继续创建同类对象
autoSelectCreatedAnnotation	true	自动选中新创建的注释或表单域

需要连续绘制且不选中新对象时，可将两个参数分别设置为 true 和 false。

适用范围

此策略用于阅读器的注释、表单交互工具，也适用于通过控制器选择的创建工具。它不改变 CPDFDocument.addAnnotations() 或 addWidgets() 的编程创建行为。

创建策略与自定义注释创建流程分别配置。自定义创建界面仍需按回调要求完成或取消创建，不能使用 continuousCreation 代替该流程。

相关操作见创建注释和创建表单域。