Skip to content

主工具栏

ComPDFKit 的主工具栏设计灵活且高度可配置。本指南展示如何自定义主工具栏。

默认工具栏

默认工具栏包含以下工具:

AndroidiOS

自定义工具栏按钮

您可以在显示 PDF 时使用 iOS 的 iosLeftBarAvailableActionsiosRightBarAvailableActions 属性和 Android 的 androidAvailableActions 属性自定义主工具栏按钮。以下示例展示了如何在 iOS 中隐藏导航栏(主工具栏)中的菜单按钮,以及如何自定义 Android 工具栏菜单项:

dart
CPDFConfiguration configuration = CPDFConfiguration(toolbarConfig: const ToolbarConfig(
  androidAvailableActions: [
    ToolbarAction.back,
    ToolbarAction.search,
    ToolbarAction.thumbnail,
    ToolbarAction.bota,
    ToolbarAction.menu,
  ],
  iosLeftBarAvailableActions: [
    ToolbarAction.back,
    ToolbarAction.thumbnail
  ],
  iosRightBarAvailableActions: [
    ToolbarAction.search,
    ToolbarAction.bota,
  ],
));

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

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

自定义工具栏将如下所示:

AndroidiOS

可用的工具栏自定义选项

工具栏按钮项描述
back显示关闭按钮项。
thumbnail显示缩略图按钮项。
search显示搜索按钮项。
bota显示大纲、书签、注释列表按钮项。
menu显示菜单按钮项。

注意:请参考 ToolbarAction 获取相关选项。

可用的菜单自定义选项

如果配置了 ToolbarAction.menu,您可以在菜单中访问更多功能按钮。有关可配置选项,请参阅以下列表:

菜单按钮项描述
viewSettings打开设置视图并设置滚动方向、
显示模式、主题颜色等相关设置。
documentEditor打开文档缩略图列表,可以在视图中删除、旋转和添加文档页面。
documentInfo打开文档信息视图以显示基本文档信息和权限信息。
watermark打开水印编辑视图以添加文本和图像水印,并将其保存为新文档。
security打开安全设置视图,设置文档打开密码和权限密码。
flattened将文档中的注释扁平化,注释将不可编辑。
save保存 PDF 文档。
share打开系统共享功能。
openDocument打开系统文件选择器并打开新 PDF 文档。

注意:请参考 ToolbarMenuAction 获取相关选项。