将 PowerPoint 转换为 HTML 在 C++

概述

本文解释了如何使用 C++ 将 PowerPoint 演示文稿转换为 HTML 格式。它涵盖以下主题。

在 C++ 中将 PowerPoint 转换为 HTML
在 C++ 中将 PPT 转换为 HTML
在 C++ 中将 PPTX 转换为 HTML
在 C++ 中将 ODP 转换为 HTML
在 C++ 中将 PowerPoint 幻灯片转换为 HTML

C++ PowerPoint 转 HTML

有关将 PowerPoint 转换为 HTML 的 C++ 示例代码，请参见下面的部分，即在 C++ 中将 PowerPoint 转换为 HTML。该代码可以在演示对象中加载多种格式，如 PPT、PPTX 和 ODP，并将其保存为 HTML 格式。

关于 PowerPoint 到 HTML 转换

使用 Aspose.Slides for C++，应用程序和开发人员可以将 PowerPoint 演示文稿转换为 HTML：PPTX 转 HTML 或 PPT 转 HTML。

Aspose.Slides 提供多种选项（主要来自 HtmlOptions 类），定义 PowerPoint 到 HTML 的转换过程：

将整个 PowerPoint 演示文稿转换为 HTML。
将 PowerPoint 演示文稿中的特定幻灯片转换为 HTML。
将演示文稿媒体（图像、视频等）转换为 HTML。
将 PowerPoint 演示文稿转换为响应式 HTML。
将 PowerPoint 演示文稿转换为包含或不包含发言者备注的 HTML。
将 PowerPoint 演示文稿转换为包含或不包含评论的 HTML。
将 PowerPoint 演示文稿转换为使用原始或嵌入字体的 HTML。
在转换 PowerPoint 演示文稿为 HTML 时使用新的 CSS 样式。

使用其自己的 API，Aspose 开发了免费的演示文稿到 HTML 转换器：PPT 转 HTML，PPTX 转 HTML，ODP 转 HTML 等等。

您可能想要查看来自 Aspose 的其他免费转换器。

注意

除了此处描述的转换过程外，Aspose.Slides 还支持涉及 HTML 格式的以下转换操作：

将 PowerPoint 转换为 HTML

使用 Aspose.Slides，您可以以这种方式将整个 PowerPoint 演示文稿转换为 HTML：

创建 Presentation 类的实例。
- 在 Presentation 类中加载 .ppt 以在 C++ 中将 PPT 转换为 HTML
- 在 Presentation 类中加载 .pptx 以在 C++ 中将 PPTX 转换为 HTML
- 在 Presentation 类中加载 .odp 以在 C++ 中将 ODP 转换为 HTML
使用 Save 方法将对象保存为 HTML 文件。

以下代码向您展示了如何在 C++ 中将 PowerPoint 转换为 HTML：

// 实例化一个 Presentation 对象，表示一个演示文稿文件
auto presentation = System::MakeObject<Presentation>(u"Convert_HTML.pptx");
    
auto htmlOpt = System::MakeObject<HtmlOptions>();
htmlOpt->set_HtmlFormatter(HtmlFormatter::CreateDocumentFormatter(u"", false));

// 将演示文稿保存为 HTML
presentation->Save(u"ConvertWholePresentationToHTML_out.html", SaveFormat::Html, htmlOpt);

将 PowerPoint 转换为响应式 HTML

Aspose.Slides 提供了 ResponsiveHtmlController 类，允许您生成响应式 HTML 文件。以下代码向您展示了如何在 C++ 中将 PowerPoint 演示文稿转换为响应式 HTML：

// 实例化一个 Presentation 对象，表示一个演示文稿文件
auto presentation = System::MakeObject<Presentation>(u"Convert_HTML.pptx");

auto controller = System::MakeObject<ResponsiveHtmlController>();
auto htmlOptions = System::MakeObject<HtmlOptions>();
htmlOptions->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(controller));

// 将演示文稿保存为 HTML
presentation->Save(u"ConvertPresentationToResponsiveHTML_out.html", SaveFormat::Html, htmlOptions);

将 PowerPoint 转换为包含备注的 HTML

以下代码向您展示了如何在 C++ 中将 PowerPoint 转换为包含备注的 HTML：

auto pres = System::MakeObject<Presentation>(u"Presentation.pptx");

auto opt = System::MakeObject<HtmlOptions>();

auto options = opt->get_NotesCommentsLayouting();
options->set_NotesPosition(NotesPositions::BottomFull);

// 保存备注页面
pres->Save(u"Output.html", SaveFormat::Html, opt);

将 PowerPoint 转换为 HTML 时保留原始字体

Aspose.Slides 提供了 EmbedAllFontsHtmlController 类，允许您在将演示文稿转换为 HTML 时嵌入所有字体。

为了防止某些字体被嵌入，您可以将字体名称的数组传递给 EmbedAllFontsHtmlController 类的参数化构造函数。常用字体，如 Calibri 或 Arial，当在演示文稿中使用时，不必嵌入，因为大多数系统已经包含了这些字体。当这些字体被嵌入时，生成的 HTML 文档就会变得不必要地大。

EmbedAllFontsHtmlController 类支持继承，并提供 WriteFont 方法，该方法旨在被重写。

auto pres = System::MakeObject<Presentation>(u"input.pptx");

// 排除默认演示文稿字体
auto fontNameExcludeList = System::MakeArray<System::String>({ u"Calibri", u"Arial" });

auto embedFontsController = System::MakeObject<EmbedAllFontsHtmlController>(fontNameExcludeList);

auto htmlOptionsEmbed = System::MakeObject<HtmlOptions>();
htmlOptionsEmbed->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(embedFontsController));

pres->Save(u"input-PFDinDisplayPro-Regular-installed.html", SaveFormat::Html, htmlOptionsEmbed);

将 PowerPoint 转换为具有高质量图像的 HTML

默认情况下，当您将 PowerPoint 转换为 HTML 时，Aspose.Slides 输出小的 HTML，其图像为 72 DPI 并删除裁剪区域。要获得具有更高质量图像的 HTML 文件，您必须将 PicturesCompression 属性（来自 HtmlOptions 类）设置为 96（即 PicturesCompression::Dpi96）或更高的值。

以下 C++ 代码向您展示了如何将 PowerPoint 演示文稿转换为 HTML，同时获得 150 DPI（即 PicturesCompression::Dpi150）的高质量图像：

auto pres = System::MakeObject<Presentation>(u"InputDoc.pptx");

auto htmlOpts = System::MakeObject<HtmlOptions>();
htmlOpts->set_PicturesCompression(PicturesCompression::Dpi150);

pres->Save(u"OutputDoc-dpi150.html", SaveFormat::Html, htmlOpts);

以下代码在 C++ 中向您展示了如何输出具有完整质量图像的 HTML：

auto pres = System::MakeObject<Presentation>(u"InputDoc.pptx");

auto htmlOpts = System::MakeObject<HtmlOptions>();
htmlOpts->set_DeletePicturesCroppedAreas(false);

pres->Save(u"Outputdoc-noCrop.html", SaveFormat::Html, htmlOpts);

将幻灯片转换为 HTML

要将 PowerPoint 中的特定幻灯片转换为 HTML，您必须实例化相同的 Presentation 类（用于将整个演示文稿转换为 HTML），然后使用 Save 方法将文件保存为 HTML。HtmlOptions 类可以用来指定额外的转换选项：

以下 C++ 代码向您展示了如何将 PowerPoint 演示文稿中的幻灯片转换为 HTML：

class CustomFormattingController : public IHtmlFormattingController
{
public:
    void WriteDocumentStart(SharedPtr<IHtmlGenerator> generator, SharedPtr<IPresentation> presentation) override{}
    void WriteDocumentEnd(SharedPtr<IHtmlGenerator> generator, SharedPtr<IPresentation> presentation) override{}
    void WriteSlideStart(SharedPtr<IHtmlGenerator> generator, SharedPtr<ISlide> slide) override
    {
        generator->AddHtml(String::Format(SlideHeader, generator->get_SlideIndex() + 1));
    }
    void WriteSlideEnd(SharedPtr<IHtmlGenerator> generator, SharedPtr<ISlide> slide) override
    {
        generator->AddHtml(SlideFooter);
    }
    void WriteShapeStart(SharedPtr<IHtmlGenerator> generator, SharedPtr<IShape> shape) override{}
    void WriteShapeEnd(SharedPtr<IHtmlGenerator> generator, SharedPtr<IShape> shape) override{}

private:
    static const String SlideHeader;
    static const String SlideFooter;
};

const String CustomFormattingController::SlideHeader = u"<div class=\"slide\" name=\"slide\" id=\"slide{0}\">";
const String CustomFormattingController::SlideFooter = u"</div>";

void Run()
{
    String dataDir = GetDataPath();
    
    auto presentation = System::MakeObject<Presentation>(dataDir + u"Individual-Slide.pptx");

    auto formatter = HtmlFormatter::CreateCustomFormatter(MakeObject<CustomFormattingController>());
    auto htmlOptions = System::MakeObject<HtmlOptions>();
    htmlOptions->set_HtmlFormatter(formatter);

    // 保存文件              
    for (int32_t i = 0; i < presentation->get_Slides()->get_Count(); i++)
    {
        presentation->Save(dataDir + u"Individual Slide" + (i + 1) + u"_out.html", 
            MakeArray<int32_t>({ i + 1 }), SaveFormat::Html, htmlOptions);
    }
}

导出 HTML 时保存 CSS 和图像

使用新的 CSS 样式文件，您可以轻松地改变由 PowerPoint 到 HTML 转换过程生成的 HTML 文件的样式。

以下 C++ 代码示例向您展示了如何使用可覆盖的方法创建一个自定义 HTML 文档，并链接到 CSS 文件：

class CustomHeaderAndFontsController : public EmbedAllFontsHtmlController
{
public:
    CustomHeaderAndFontsController(String cssFileName)
        : m_cssFileName(cssFileName)
    {
    }

    void WriteDocumentStart(SharedPtr<IHtmlGenerator> generator, SharedPtr<IPresentation> presentation) override
    {
        generator->AddHtml(System::String::Format(Header, m_cssFileName));
        WriteAllFonts(generator, presentation);
    }

    void WriteAllFonts(SharedPtr<IHtmlGenerator> generator, SharedPtr<IPresentation> presentation) override
    {
        generator->AddHtml(u"<!-- 嵌入字体 -->");
        EmbedAllFontsHtmlController::WriteAllFonts(generator, presentation);
    }

private:
    static const String Header;
    String m_cssFileName;
};

const String CustomHeaderAndFontsController::Header = String(u"<!DOCTYPE html>\n") + 
u"<html>\n" + u"<head>\n" + 
u"<meta http-equiv=\"Content-Type\" content=\"text/html;charset=UTF-8\">\n" + 
u"<meta http-equiv=\"X-UA-Compatible\" content=\"IE=9\">\n" + 
u"<link rel=\"stylesheet\" type=\"text/css\" href=\"{0}\">\n" + u"</head>";

void Run()
{
    // 文档目录的路径。
    System::String dataDir = GetDataPath();

    auto pres = System::MakeObject<Presentation>(u"pres.pptx");

    auto htmlController = System::MakeObject<CustomHeaderAndFontsController>(u"styles.css");
    auto options = System::MakeObject<HtmlOptions>();
    options->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(htmlController));
    pres->Save(u"pres.html", SaveFormat::Html, options);
}

在转换演示文稿为 HTML 时链接所有字体

如果您不想嵌入字体（以避免增加生成 HTML 的大小），您可以通过实现自己的 LinkAllFontsHtmlController 版本来链接所有字体。

以下 C++ 代码展示了如何在将 PowerPoint 转换为 HTML 时链接所有字体，并排除 “Calibri” 和 “Arial”（因为它们已经存在于系统中）：

class LinkAllFontsHtmlController : public EmbedAllFontsHtmlController
{
public:
    LinkAllFontsHtmlController(ArrayPtr<String> fontNameExcludeList, String basePath)
        :   EmbedAllFontsHtmlController(fontNameExcludeList)
    {
        m_basePath = basePath;
    }

    void WriteFont(SharedPtr<IHtmlGenerator> generator, SharedPtr<IFontData> originalFont, SharedPtr<IFontData> substitutedFont,
        String fontStyle, String fontWeight, ArrayPtr<uint8_t> fontData)
    {
        String fontName = substitutedFont == nullptr ? originalFont->get_FontName() : substitutedFont->get_FontName();
        String path = String::Format(u"{0}.woff", fontName); // 可能需要一些路径清理
        IO::File::WriteAllBytes(IO::Path::Combine(m_basePath, path), fontData);

        generator->AddHtml(u"<style>");
        generator->AddHtml(u"@font-face { ");
        generator->AddHtml(String::Format(u"font-family: '{0}'; ", fontName));
        generator->AddHtml(String::Format(u"src: url('{0}')", path));

        generator->AddHtml(u" }");
        generator->AddHtml(u"</style>");
    }

private:
    String m_basePath;
};

void Run()
{
    auto pres = System::MakeObject<Presentation>(u"pres.pptx");

    // 排除默认演示文稿字体
    auto fontNameExcludeList = System::MakeArray<String>({ u"Calibri", u"Arial" });
    
    auto linkcont = System::MakeObject<LinkAllFontsHtmlController>(fontNameExcludeList, u"C://Windows//Fonts//");

    System::SharedPtr<HtmlOptions> htmlOptionsEmbed = System::MakeObject<HtmlOptions>();
    htmlOptionsEmbed->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(linkcont));
    
    pres->Save(u"pres.html", SaveFormat::Html, htmlOptionsEmbed);
}

将 PowerPoint 转换为响应式 HTML

以下 C++ 代码向您展示了如何将 PowerPoint 演示文稿转换为响应式 HTML：

auto presentation = System::MakeObject<Presentation>(u"SomePresentation.pptx");
auto saveOptions = System::MakeObject<HtmlOptions>();
saveOptions->set_SvgResponsiveLayout(true);
presentation->Save(u"SomePresentation-out.html", SaveFormat::Html, saveOptions);

导出媒体文件到 HTML

使用 Aspose.Slides for C++，您可以以如下方式导出媒体文件：

创建 Presentation 类的实例。
获取对幻灯片的引用。
向幻灯片添加视频。
将演示文稿写入 HTML 文件。

以下 C++ 代码向您展示了如何将视频添加到演示文稿中，然后将其保存为 HTML：

 // 加载演示文稿
auto pres = System::MakeObject<Presentation>();

const System::String path = u"C:/out/";
const System::String fileName = u"ExportMediaFiles_out.html";
const System::String baseUri = u"http://www.example.com/";

auto fileStream = System::MakeObject<IO::FileStream>(u"my_video.avi", IO::FileMode::Open, IO::FileAccess::Read);

auto video = pres->get_Videos()->AddVideo(fileStream, Aspose::Slides::LoadingStreamBehavior::ReadStreamAndRelease);

auto slide = pres->get_Slides()->idx_get(0);
slide->get_Shapes()->AddVideoFrame(10.0f, 10.0f, 100.0f, 100.0f, video);

auto controller = System::MakeObject<VideoPlayerHtmlController>(path, fileName, baseUri);

// 设置 HTML 选项
auto htmlOptions = System::MakeObject<HtmlOptions>(controller);
auto svgOptions = System::MakeObject<SVGOptions>(controller);

htmlOptions->set_HtmlFormatter(HtmlFormatter::CreateCustomFormatter(controller));
htmlOptions->set_SlideImageFormat(SlideImageFormat::Svg(svgOptions));

// 保存文件
pres->Save(IO::Path::Combine(path, fileName), SaveFormat::Html, htmlOptions);

将PPTX转换为PPT的C++ 在 C++ 中将 PowerPoint 转换为 PDF