C++ で PPT と PPTX を PDF に変換(高度な機能を含む)
概要
PowerPoint プレゼンテーション(PPT、PPTX、ODP など)を C++ で PDF 形式に変換すると、さまざまなデバイス間での互換性やプレゼンテーションのレイアウトおよび書式を保持できるという利点があります。本ガイドでは、プレゼンテーションを PDF に変換する方法、画像品質を制御するオプションの使用、非表示スライドの含め方、PDF ファイルのパスワード保護、フォント置換の検出、特定スライドの選択変換、出力ドキュメントへのコンプライアンス基準の適用方法について説明します。
PowerPoint から PDF への変換
Aspose.Slides を使用すると、次の形式のプレゼンテーションを PDF に変換できます。
- PPT
- PPTX
- ODP
プレゼンテーションを PDF に変換するには、ファイル名を引数として Presentation クラスに渡し、Save メソッドで PDF として保存します。[Presentation](https://reference.aspose.com/slides/ja/cpp/aspose.slides/presentation/) クラスは、通常プレゼンテーションを PDF に変換するために使用される Save メソッドを提供します。
NOTE
Aspose.Slides for C++ は、出力ドキュメントに API 情報とバージョン番号を挿入します。たとえば、プレゼンテーションを PDF に変換する際、Aspose.Slides は Application フィールドに「Aspose.Slides」を、PDF Producer フィールドに「Aspose.Slides v XX.XX」形式の値を設定します。注意:この情報を出力ドキュメントから変更または削除することはできません。Aspose.Slides では、次の変換が可能です。
- プレゼンテーション全体を PDF に変換
- プレゼンテーションから特定のスライドだけを PDF に変換
Aspose.Slides はプレゼンテーションを PDF にエクスポートし、元のプレゼンテーションに非常に近い形で PDF を生成します。変換時には次の要素と属性が正確にレンダリングされます。
- 画像
- テキスト ボックスと図形
- テキスト書式設定
- 段落書式設定
- ハイパーリンク
- ヘッダーとフッター
- 箇条書き
- 表
PowerPoint を PDF に変換
標準の PowerPoint から PDF への変換プロセスはデフォルトオプションを使用します。この場合、Aspose.Slides は最大品質レベルで最適な設定を使用してプレゼンテーションを PDF に変換しようとします。
以下の C++ コードは、プレゼンテーション(PPT、PPTX、ODP など)を PDF に変換する方法を示しています。
// PowerPoint または OpenDocument ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"PowerPoint.ppt");
// プレゼンテーションを PDF として保存します。
presentation->Save(u"PPT-to-PDF.pdf", SaveFormat::Pdf);
presentation->Dispose();
オプション付きで PowerPoint を PDF に変換
Aspose.Slides は、PdfOptions クラス配下のカスタムオプション(プロパティ)を提供し、生成される PDF のカスタマイズ、パスワードでのロック、変換プロセスの制御が可能です。
カスタムオプションで PowerPoint を PDF に変換
カスタム変換オプションを使用すると、ラスタ画像の品質設定、メタファイルの処理方法、テキストの圧縮レベル、画像の DPI などを指定できます。
以下のコード例は、複数のカスタムオプションを使用して PowerPoint プレゼンテーションを PDF に変換する方法を示しています。
// PdfOptions クラスのインスタンスを作成します。
auto pdfOptions = MakeObject<PdfOptions>();
// JPG 画像の品質を設定します。
pdfOptions->set_JpegQuality(90);
// 画像の DPI を設定します。
pdfOptions->set_SufficientResolution(300);
// メタファイルの動作を設定します。
pdfOptions->set_SaveMetafilesAsPng(true);
// テキストコンテンツの圧縮レベルを設定します。
pdfOptions->set_TextCompression(PdfTextCompression::Flate);
// PDF コンプライアンスモードを定義します。
pdfOptions->set_Compliance(PdfCompliance::Pdf15);
// PowerPoint または OpenDocument ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"PowerPoint.pptx");
// プレゼンテーションを PDF ドキュメントとして保存します。
presentation->Save(u"PowerPoint-to-PDF.pdf", SaveFormat::Pdf, pdfOptions);
presentation->Dispose();
非表示スライドを含めて PowerPoint を PDF に変換
プレゼンテーションに非表示スライドが含まれる場合、PdfOptions クラスの set_ShowHiddenSlides メソッドを使用して、非表示スライドを結果の PDF のページとして含めることができます。
以下の C++ コードは、非表示スライドを含めて PowerPoint プレゼンテーションを PDF に変換する方法を示しています。
// PowerPoint または OpenDocument ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"PowerPoint.pptx");
// PdfOptions クラスのインスタンスを作成します。
auto pdfOptions = MakeObject<PdfOptions>();
// 非表示スライドを追加します。
pdfOptions->set_ShowHiddenSlides(true);
// プレゼンテーションを PDF として保存します。
presentation->Save(u"PowerPoint-to-PDF.pdf", SaveFormat::Pdf, pdfOptions);
presentation->Dispose();
パスワード保護付き PDF に PowerPoint を変換
この C++ コードは、PdfOptions クラスの保護パラメータを使用して、PowerPoint プレゼンテーションをパスワード保護付き PDF に変換する方法を示しています。
// PowerPoint または OpenDocument ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"PowerPoint.pptx");
// PdfOptions クラスのインスタンスを作成します。
auto pdfOptions = MakeObject<PdfOptions>();
// PDF のパスワードとアクセス許可を設定します。
pdfOptions->set_Password(u"password");
pdfOptions->set_AccessPermissions(PdfAccessPermissions::PrintDocument | PdfAccessPermissions::HighQualityPrint);
// プレゼンテーションを PDF として保存します。
presentation->Save(u"PPTX-to-PDF.pdf", SaveFormat::Pdf, pdfOptions);
presentation->Dispose();
フォント置換の検出
Aspose.Slides は、PdfOptions クラスの下にある set_WarningCallback メソッドを提供し、プレゼンテーションから PDF への変換プロセス中にフォント置換を検出できます。
以下の C++ コードは、フォント置換を検出する方法を示しています。
// 警告コールバックの実装。
class FontSubstitutionHandler : public IWarningCallback
{
public:
ReturnAction Warning(SharedPtr<IWarningInfo> warning) override;
};
ReturnAction FontSubstitutionHandler::Warning(SharedPtr<IWarningInfo> warning)
{
if (warning->get_WarningType() == WarningType::DataLoss &&
warning->get_Description().StartsWith(u"Font will be substituted"))
{
Console::WriteLine(u"Font substitution warning: {0}", warning->get_Description());
}
return ReturnAction::Continue;
}
int main()
{
// PowerPoint または OpenDocument ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"sample.pptx");
// PDF オプションで警告コールバックを設定します。
auto pdfOptions = MakeObject<PdfOptions>();
pdfOptions->set_WarningCallback(MakeObject<FontSubstitutionHandler>());
// プレゼンテーションを PDF として保存します。
presentation->Save(u"output.pdf", SaveFormat::Pdf, pdfOptions);
presentation->Dispose();
return 0;
}
レンダリング中のフォント置換に対するコールバック取得の詳細は、Getting Warning Callbacks for Fonts Substitution を参照してください。
フォント置換に関する詳細は、Font Substitution 記事をご覧ください。
選択したスライドだけを PowerPoint から PDF に変換
この C++ コードは、PowerPoint プレゼンテーションから特定のスライドだけを PDF に変換する方法を示しています。
// PowerPoint または OpenDocument ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"PowerPoint.pptx");
// スライド番号の配列を設定します。
auto slides = MakeArray<int32_t>({ 1, 3 });
// プレゼンテーションを PDF として保存します。
presentation->Save(u"PPTX-to-PDF.pdf", slides, SaveFormat::Pdf);
presentation->Dispose();
カスタムスライドサイズで PowerPoint を PDF に変換
この C++ コードは、指定したスライドサイズで PowerPoint プレゼンテーションを PDF に変換する方法を示しています。
auto slideWidth = 612;
auto slideHeight = 792;
// PowerPoint または OpenDocument ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"SelectedSlides.pptx");
// Create a new presentation with an adjusted slide size.
auto resizedPresentation = MakeObject<Presentation>();
// Set the custom slide size.
resizedPresentation->get_SlideSize()->SetSize(slideWidth, slideHeight, SlideSizeScaleType::EnsureFit);
// Clone the first slide from the original presentation.
auto slide = presentation->get_Slide(0);
resizedPresentation->get_Slides()->InsertClone(0, slide);
// Save the resized presentation to a PDF with notes.
resizedPresentation->Save(u"PDF_with_notes.pdf", SaveFormat::Pdf);
resizedPresentation->Dispose();
presentation->Dispose();
ノートスライドビューで PowerPoint を PDF に変換
この C++ コードは、ノートを含む PDF を生成するために PowerPoint プレゼンテーションを変換する方法を示しています。
// PowerPoint または OpenDocument ファイルを表す Presentation クラスのインスタンスを作成します。
auto presentation = MakeObject<Presentation>(u"SelectedSlides.pptx");
// Notes レイアウトで PDF オプションを設定します。
auto notesOptions = MakeObject<NotesCommentsLayoutingOptions>();
notesOptions->set_NotesPosition(NotesPositions::BottomFull);
auto pdfOptions = MakeObject<PdfOptions>();
pdfOptions->set_SlidesLayoutOptions(notesOptions);
// ノート付きでプレゼンテーションを PDF として保存します。
presentation->Save(u"PDF_with_notes.tiff", SaveFormat::Pdf, pdfOptions);
presentation->Dispose();
PDF のアクセシビリティとコンプライアンス基準
Aspose.Slides は、Web Content Accessibility Guidelines (WCAG) に準拠した変換手順を使用できます。次のコンプライアンス標準のいずれかで PowerPoint 文書を PDF にエクスポートできます:PDF/A1a、PDF/A1b、PDF/UA。
以下の C++ コードは、異なるコンプライアンス標準に基づいて複数の PDF を生成する PowerPoint から PDF への変換プロセスを示しています。
auto presentation = MakeObject<Presentation>(u"pres.pptx");
auto pdfOptionsA1a = MakeObject<PdfOptions>();
pdfOptionsA1a->set_Compliance(PdfCompliance::PdfA1a);
presentation->Save(u"pres-a1a-compliance.pdf", SaveFormat::Pdf, pdfOptionsA1a);
auto pdfOptionsA1b = MakeObject<PdfOptions>();
pdfOptionsA1b->set_Compliance(PdfCompliance::PdfA1b);
presentation->Save(u"pres-a1b-compliance.pdf", SaveFormat::Pdf, pdfOptionsA1b);
auto pdfOptionsUa = MakeObject<PdfOptions>();
pdfOptionsUa->set_Compliance(PdfCompliance::PdfUa);
presentation->Save(u"pres-ua-compliance.pdf", SaveFormat::Pdf, pdfOptionsUa);
presentation->Dispose();
Note
Aspose.Slides は PDF 変換操作もサポートしており、PDF ファイルを一般的な形式に変換できます。PDF to HTML、PDF to image、PDF to JPG、PDF to PNG の変換が可能です。さらに、PDF to SVG、PDF to TIFF、PDF to XML といった特殊形式への変換もサポートされています。注意: PDF/UA にエクスポートする際、Aspose.Slides は SmartArt、チャート、数式などの複雑なグラフィックを単一の図形として扱います。個々のパス要素は別個のコンテンツとして保持されず、アーティファクトとしてマークされる可能性があります。代替テキストは全体の図形に対してのみ提供されます。
FAQ
複数の PowerPoint ファイルを一括で PDF に変換できますか?
はい、Aspose.Slides は複数の PPT または PPTX ファイルを PDF にバッチ変換する機能をサポートしています。ファイルを列挙し、プログラムで変換プロセスを適用できます。
変換後の PDF にパスワードを設定できますか?
もちろんです。PdfOptions クラスを使用して、変換中にパスワードとアクセス権限を設定できます。
PDF に非表示スライドを含めるにはどうすればよいですか?
PdfOptions クラスの set_ShowHiddenSlides メソッドを使用して、結果の PDF に非表示スライドを含めます。
Aspose.Slides は PDF の画像品質を高く保てますか?
はい、set_JpegQuality や set_SufficientResolution などのメソッドを PdfOptions クラスで使用することで、PDF 内の画像品質を高く保つことができます。
Aspose.Slides は PDF/A コンプライアンス標準をサポートしていますか?
はい、Aspose.Slides は PDF/A1a、PDF/A1b、PDF/UA などのさまざまな標準に準拠した PDF のエクスポートをサポートし、アクセシビリティとアーカイブ要件を満たします。