表单工具栏

在 ComPDFKit 中，表单工具栏可以灵活配置，使用户能够选择表单类型和工具。本节将介绍如何自定义表单工具栏。

默认表单工具栏

默认的表单工具栏包含以下表单类型和工具：

Android	iOS

自定义工具栏按钮

您可以通过在 formsConfig 对象中设置 availableTypes 属性来启用或隐藏特定的表单类型。以下示例演示了如何调整表单类型，仅启用文本字段和列表框。

CPDFConfiguration configuration = CPDFConfiguration(
  formsConfig: const CPDFFormsConfig(availableTypes: [
    CPDFFormType.textField,
    CPDFFormType.listBox
  ], availableTools: [
    CPDFFormConfigTool.undo,
    CPDFFormConfigTool.redo
  ]));

// CPDFReaderWidget 示例
Scaffold(
  resizeToAvoidBottomInset: false,
  appBar: AppBar(),
  body: CPDFReaderWidget(
    document: documentPath,
    configuration: configuration,
    onCreated: (controller) {},
  ));

// ComPDFKit.openDocument 示例
ComPDFKit.openDocument(documentPath, '', configuration)

自定义的工具栏将如下所示。

Android	iOS

可用的工具栏自定义选项

类型
CPDFFormType.textField
CPDFFormType.checkBox
CPDFFormType.radioButton
CPDFFormType.listBox
CPDFFormType.comboBox
CPDFFormType.signaturesFields
CPDFFormType.pushButton

注意：请参考 CPDFFormType 获取相关选项。

可用的工具栏工具自定义选项

工具	描述
SETTING	设置按钮，对应打开所选注释、文本或图片属性面板。
UNDO	撤销注释、内容编辑、表单操作。
REDO	重做被撤销的操作。

注意：请参考 CPDFFormConfigTool获取相关选项。

显示或隐藏工具栏

可以通过配置 CPDFConfiguration 来控制表单模式下底部工具栏的显示状态。

CPDFConfiguration configuration = CPDFConfiguration(
  // 设置表单模式底部工具栏是否可见
  toolbarConfig: const CPDFToolbarConfig(formToolbarVisible: false),
);