PDF ファイルへのエクスポート

DioDocs for Excel では、ワークブックを PDF ファイルにエクスポートすることができます。また、エクスポート操作を実行する際、スタイルの適用、フォントのカスタマイズ、セキュリティオプションの追加、ドキュメントプロパティの設定、行の高さや列の幅の調整を行うこともできます。

ワークブックに表示されているすべてのワークシートを Portable Document File（PDF）に保存するには、WorkbookクラスのSaveメソッドを使用します。ワークブック内の各ワークシートは、PDF ファイルの新しいページに保存されます。また、現在のシート（アクティブシート）のみを PDF 形式にエクスポートする場合は、IWorksheet インタフェースの Save() メソッドを使用します。

PDF へのエクスポートの際、画像も非常に効率的に処理されます。 DioDocs for Excel では、同じ画像が複数回使用されている場合、画像のコピーを 1 つのみ保持するため、エクスポートされる PDF ファイルのサイズが縮小されます。

ワークブックを PDF ファイルにエクスポートする方法については、次のサンプルコードを参照してください。

// ワークブックを作成し、ワークシートを 2 つにします
Workbook workbook = new Workbook();
IWorksheet sheet1 = workbook.Worksheets[0];
IWorksheet sheet2 = workbook.Worksheets.Add();

// ワークブックを PDF ファイルにエクスポートします（エクスポートされた PDF は2ページになります）
workbook.Save(@"D:\workbook.pdf", SaveFileFormat.Pdf);

// 特定のワークシートのみを PDF ファイルにエクスポートします
sheet1.Save(@"D:\sheet1.pdf", SaveFileFormat.Pdf);

さらに、DioDocs for ExcelではPDFファイルのエクスポートをカスタマイズするためのPdfSaveOptionsクラスを提供しています。これらのオプションは以下のとおりです：

	クラス	オプション	説明
Export Options	PdfSaveOptions	BorderOptions	PDF へのエクスポートの際、罫線オプションを設定します。
		DocumentProperties	PDF のドキュメントプロパティを表します。
		FileFormat	ワークブックを保存する形式を表します。
		FormFields	Excel のフォームコントロールを PDF のフォームフィールドに変換するかどうかを指定します。すべてのコントロールやプロパティがサポートされているわけではありません。
		ImageQuality	画像品質（パーセント）を 0（最低品質、最大圧縮）から 100（最高品質、圧縮なし）の範囲で指定します。既定値は 75 です。 JPEG形式の画像にはこのプロパティは適用できません。
		OpenActionScript	保存された PDF ファイルを開いた時に実行する JavaScript を設定します。
		PrintBackgroundPicture	シートの背景画像をページに印刷するかどうかを指定します。
		PrintTransparentCell	セルの背景色の透明度をページに印刷するかどうかを指定します。
		SecurityOptions	PDF のセキュリティ設定を表します。
		ShrinkToFitSettings	折り返し文字列に対して Shrink to Fit を実行する際の設定を指定します。
		ViewerPreferences	ドキュメントの表示方法を指定する設定情報を含みます。
		IncludeAutoMergedCells	自動的に結合されたセルを含めるかどうかを指定します。既定値は false です。

DioDocs for Excel では、PdfSaveOptions クラスの OpenActionScript プロパティを使用して、PDF ドキュメントに JavaScript を設定することができます。保存された PDF ドキュメントが開かれた際に JavaScript が実行されます。

次のサンプルコードは、テンプレート構文にて作成される PDF フォームに JavaScript を設定する方法を示します。

Workbook workbook = new Workbook();
workbook.Open("SampleTemplate.xlsx");

workbook.ProcessTemplate();
PdfSaveOptions options = new PdfSaveOptions();

//JavaScriptを設定します
options.OpenActionScript = "var fld1 = this.getField(\"num\");" +
"fld1.value = fld1.value;" +
"this.dirty = false;";

workbook.Save("SampleTemplate.pdf", options);

エクスポート操作の実行時に必要に応じて PDF をカスタマイズするために、フォントの設定、スタイルの設定、ページ設定のオプションを指定できます。詳細については、以下のトピックを参照してください。

PDF ドキュメントの印刷時に、PDF の用紙サイズに基づいて自動的に用紙トレイを選択するように設定することもできます。詳細については、「用紙トレイの設定」を参照してください。

制限事項

DioDocs for Excel では、画像の設定（LineFormat、FillFormat、Brightness、Contrast、Watermark Color Type、および emf 形式の白黒画像など）の PDF ファイルへのエクスポートには対応しておりません。
また、PatternType 列挙体の DiagonalCross、Horizontal、Vertical、Cross、DashedUpwardDiagonal、DashedDownwardDiagonal については、DioDocs for Excel において描画上の制限が存在します。