使用书签导出为 PDF

当您将复杂的绘图导出为 PDF 文件或根据多个绘图的内容创建 PDF 文件时，您可能希望使用书签来组织生成的 PDF 文档中的导航。

PDF 导出模块为每个导出的布局创建一个书签。当用户点击书签时，PDF 文档的相应页面将变为活动状态。

默认情况下，书签根据布局的名称命名。但是，可以通过调用 PDFExportParams 类的 setLayoutNames() 方法来自定义为相应布局创建的书签名称。输出 PDF 文档中的书签名称会添加到布局名称之后。

请务必记住，包含名称的数组大小必须与导出到 PDF 文档的布局数组大小相同。

如果您只导出活动布局（即，当布局可能未设置时），布局名称数组必须只包含一个元素。

以下代码片段是应用程序中设置布局名称的示例：

PDFExportParams params;

//Setting other export parameters

OdStringArray layoutNames = params.layouts();

for(OdUInt32 i = 0; i < layoutNames.size(); i++)
{
   layoutNames[i] = L"Page " + odDToStr(i + 1, 'G', 6) +  ": " + layoutNames[i];
}
params.setLayoutNames(layoutNames);

有关导出布局的更多信息，请参阅导出布局并设置 PDF 页面参数。

您还可以将原始绘图中的命名视图导出为 PDF 视图和书签。

命名视图是一种自定义视图，它提供了一个点，可以从该点查看绘图的特定部分（如下图所示）。

一些命名视图也可以作为书签导出到 PDF。例如：

只有与导出布局平面平行的命名视图才能导出到 PDF。例如，如果导出了显示模型顶部的布局，则显示从其他方向（右、下等）查看绘图的命名视图将不会导出。即使命名视图与导出布局平面之间的角度略大于零，该视图也不会导出。

注意：命名视图无法重命名，并且始终以其在绘图中的原始名称导出到 PDF 文档。

要将布局和命名视图导出为书签，请使用 enableBookmarks() 方法，该方法属于 PDFExportParams 类。

PDFExportParams params;
params.enableBookmarks(true);

要查明书签是否已启用，请调用 bookmarksEnabled() 方法，该方法属于 PDFExportParams 类。

如果导出的多页 PDF 文档中没有书签，另一种导航方式是使用缩略图。当包含布局名称的数组正确设置为 PDFExportParams 对象时，它也适用于缩略图名称。即使书签被禁用（通过调用 enableBookmarks() 方法并传入 false），布局名称数组仍将用于生成的 PDF 文档中的缩略图名称。

如需了解更多信息，请参阅ODA 文档。