複雑な図面をPDFファイルにエクスポートしたり、複数の図面の内容に基づいてPDFファイルを作成したりする場合、結果のPDFドキュメント内のナビゲーションを整理するためにブックマークを使用したい場合があります。
PDFエクスポートモジュールは、エクスポートされたすべてのレイアウトに対してブックマークを作成します。ユーザーがブックマークをクリックすると、PDFドキュメントの対応するページがアクティブになります。
デフォルトでは、ブックマークはレイアウトの名前に従って命名されます。しかし、対応するレイアウト用に作成されたブックマークの名前は、PDFExportParamsクラスのsetLayoutNames()メソッドを呼び出すことでカスタマイズできます。出力PDFドキュメント内のブックマークの名前は、レイアウト名の後に追加されます。
名前を含む配列のサイズは、PDFドキュメントにエクスポートされるレイアウトの配列と同じサイズである必要があることを覚えておくことが重要です。
アクティブなレイアウトのみをエクスポートする場合(つまり、レイアウトが設定されていない可能性がある場合)、レイアウト名の配列は1つの要素のみで構成されている必要があります。
次のコードフラグメントは、アプリケーションでレイアウト名を設定する例です。
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ドキュメントを参照してください。