Skip to content

主工具栏

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

默认工具栏

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

AndroidiOS

自定义工具栏按钮

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

tsx
let config = ComPDFKit.getDefaultConfig({
  toolbarConfig: {
    // 仅适用于 iOS 平台
    iosLeftBarAvailableActions: [
      CPDFToolbarAction.BACK,
      CPDFToolbarAction.THUMBNAIL
    ],
    // 仅适用于 iOS 平台
    iosRightBarAvailableActions: [
      CPDFToolbarAction.SEARCH,
      CPDFToolbarAction.BOTA
    ],
    // 仅适用于 安卓 平台
    androidAvailableActions: [
      // 返回按钮将只出现在工具栏的最左侧。
      CPDFToolbarAction.BACK,
      CPDFToolbarAction.SEARCH,
      CPDFToolbarAction.THUMBNAIL,
      CPDFToolbarAction.BOTA,
      CPDFToolbarAction.MENU
    ]
  }
});
ComPDFKit.openDocument(_document, '', config);

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

AndroidiOS

可用的工具栏自定义选项

工具栏按钮项描述
BACK显示关闭按钮项。
THUMBNAIL显示缩略图按钮项。
SEARCH显示搜索按钮项。
BOTA显示大纲、书签、注释列表按钮项。
MENU显示菜单按钮项。

注意:请参考 CPDFToolbarAction 查看相关选项。

可用的菜单自定义选项

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

菜单按钮项描述
VIEW_SETTINGS打开设置视图,并设置阅读 PDF 所需的滚动方向、显示模式、主题颜色等相关设置。
DOCUMENT_EDITOR打开文档缩略图列表,您可以在视图中删除、旋转和添加文档页面。
DOCUMENT_INFO打开文档信息视图,显示基本文档信息和权限信息。
WATERMARK打开水印编辑视图,添加文本和图像水印并将其保存为新文档。
SECURITY打开安全设置视图,设置文档打开密码和权限密码。
FLATTENED将文档中的注释扁平化,注释将不可编辑。
SAVE保存 PDF 文档。
SHARE打开系统共享功能。
OPEN_DOCUMENT打开系统文件选择器并打开新的 PDF 文档。

注意:请参考 CPDFToolbarMenuAction查看相关选项。