使用 C++ 管理演示文稿中的图片框

图片框是包含图像的形状——它就像装在相框中的图片。

您可以通过图片框向幻灯片添加图像。通过格式化图片框即可对图像进行格式化。

Tip

Aspose 提供免费的转换器——JPEG to PowerPoint 和 PNG to PowerPoint——帮助用户快速将图像创建为演示文稿。

创建图片框

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
通过向与演示文稿对象关联的 IImagescollection 中添加图像，创建一个 IPPImage 对象，以用于填充形状。
指定图像的宽度和高度。
通过引用幻灯片的形状对象公开的 AddPictureFrame 方法，基于图像的宽度和高度创建一个 PictureFrame。
将包含图片的图片框添加到幻灯片。
将修改后的演示文稿写入为 PPTX 文件。

下面的 C++ 代码演示了如何创建图片框：

// 文档目录的路径。
const String outPath = u"../out/PictureFrameFormatting_out.pptx";
const String filePath = u"../templates/Tulips.jpg";

// 加载所需的演示文稿
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// 访问第一张幻灯片
SharedPtr<ISlide> slide = pres->get_Slide(0);

// 加载将在演示文稿图像集合中添加的图像
// 获取图片
auto image = Images::FromFile(filePath);

// 将图像添加到演示文稿的图像集合中
SharedPtr<IPPImage> imgx = pres->get_Images()->AddImage(image);

// 向幻灯片添加图片框
SharedPtr<IPictureFrame> pf = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50, 50, 100, 100, imgx);

// 设置相对比例的宽度和高度
pf->set_RelativeScaleHeight(0.8);
pf->set_RelativeScaleWidth(1.35);
// 对 PictureFrame 应用一些格式设置
pf->get_LineFormat()->get_FillFormat()->set_FillType(FillType::Solid);
pf->get_LineFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Blue());
pf->get_LineFormat()->set_Width ( 20);
pf->set_Rotation( 45);

// 将 PPTX 文件写入磁盘
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

图片框可帮助您快速基于图像创建演示文稿幻灯片。将图片框与 Aspose.Slides 的保存选项结合使用，可对输入/输出操作进行操作，以实现图像格式之间的转换。您可能需要查看以下页面：转换 image to JPG；转换 JPG to image；转换 JPG to PNG，转换 PNG to JPG；转换 PNG to SVG，转换 SVG to PNG。

创建带相对比例的图片框

通过更改图像的相对缩放，可以创建更复杂的图片框。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
向演示文稿的图像集合中添加图像。
通过向与演示文稿对象关联的 IImagescollection 中添加图像，创建一个 IPPImage 对象，以用于填充形状。
在图片框中指定图像的相对宽度和高度。
将修改后的演示文稿写入为 PPTX 文件。

下面的 C++ 代码演示了如何创建带相对比例的图片框：

// 文档目录的路径。
const String outPath = u"../out/AddRelativeScaleHeightPictureFrame_out.pptx";
const String filePath = u"../templates/Tulips.jpg";

// 加载所需的演示文稿
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// 访问第一张幻灯片
SharedPtr<ISlide> slide = pres->get_Slide(0);

// 加载将在演示文稿图像集合中添加的图像
// 获取图片
auto image = Images::FromFile(filePath);

// 将图像添加到演示文稿的图像集合中
SharedPtr<IPPImage> imgx = pres->get_Images()->AddImage(image);

// 向幻灯片添加图片框
SharedPtr<IPictureFrame> pf = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50, 50, 100, 100, imgx);

// 设置相对比例的宽度和高度
pf->set_RelativeScaleHeight (0.8);
pf->set_RelativeScaleWidth(1.35);

// 将 PPTX 文件写入磁盘
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

从图片框提取光栅图像

您可以从 PictureFrame 对象中提取光栅图像，并以 PNG、JPG 等格式保存。下面的代码示例演示了如何从文档 “sample.pptx” 中提取图像并保存为 PNG 格式。

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto firstSlide = presentation->get_Slide(0);
auto firstShape = firstSlide->get_Shape(0);
    
if (ObjectExt::Is<IPictureFrame>(firstShape))
{
    auto pictureFrame = ExplicitCast<IPictureFrame>(firstShape);
    auto image = pictureFrame->get_PictureFormat()->get_Picture()->get_Image()->get_SystemImage();

    image->Save(u"slide_1_shape_1.png", ImageFormat::get_Png());
}

presentation->Dispose();

从图片框提取 SVG 图像

当演示文稿中包含放置在 PictureFrame 形状内的 SVG 图形时，Aspose.Slides for C++ 允许您以完整保真度检索原始矢量图像。通过遍历幻灯片的形状集合，可识别每个 PictureFrame，检查底层的 IPPImage 是否包含 SVG 内容，然后将该图像以原生 SVG 格式保存到磁盘或流中。

下面的代码示例演示了如何从图片框中提取 SVG 图像：

auto presentation = MakeObject<Presentation>(u"sample.pptx");

auto slide = presentation->get_Slide(0);
auto shape = slide->get_Shape(0);

if (ObjectExt::Is<IPictureFrame>(shape))
{
    auto pictureFrame = ExplicitCast<IPictureFrame>(shape);
    auto svgImage = pictureFrame->get_PictureFormat()->get_Picture()->get_Image()->get_SvgImage();
    if (svgImage != nullptr)
    {
        File::WriteAllText(u"output.svg", svgImage->get_SvgContent());
    }
}

presentation->Dispose();

获取图像的透明度

Aspose.Slides 允许您获取应用于图像的透明度效果。以下 C++ 代码演示了该操作：

auto presentation = System::MakeObject<Presentation>(u"Test.pptx");
auto pictureFrame = System::ExplicitCast<IPictureFrame>(presentation->get_Slide(0)->get_Shape(0));
auto imageTransform = pictureFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();
for (auto&& effect : imageTransform)
{
    if (System::ObjectExt::Is<IAlphaModulateFixed>(effect))
    {
        float transparencyValue = 100.0f - (System::ExplicitCast<IAlphaModulateFixed>(effect))->get_Amount();
        System::Console::WriteLine(System::String(u"Picture transparency: ") + transparencyValue);
    }
}

所有适用于图像的效果均可在 Aspose::Slides::Effects 中找到。

图片框格式化

Aspose.Slides 提供了许多可应用于图片框的格式化选项。使用这些选项，您可以调整图片框以满足特定需求。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
通过向与演示文稿对象关联的 IImagescollection 中添加图像，创建一个 IPPImage 对象，以用于填充形状。
指定图像的宽度和高度。
通过 IShapes 对象公开的 AddPictureFrame 方法，基于图像的宽度和高度创建一个 PictureFrame。
将包含图片的图片框添加到幻灯片。
设置图片框的线条颜色。
设置图片框的线条宽度。
通过正值或负值旋转图片框。
- 正值顺时针旋转图像。
- 负值逆时针旋转图像。
将图片框（包含图片）再次添加到幻灯片。
将修改后的演示文稿写入为 PPTX 文件。

下面的 C++ 代码演示了图片框格式化过程：

// 文档目录的路径。
const String outPath = u"../out/AddRelativeScaleHeightPictureFrame_out.pptx";
const String filePath = u"../templates/Tulips.jpg";

// 加载所需的演示文稿
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// 访问第一张幻灯片
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

// 加载将添加到演示文稿图像集合中的图像
// 获取图片
auto image = Images::FromFile(filePath);

// 将图像添加到演示文稿的图像集合中
SharedPtr<IPPImage> imgx = pres->get_Images()->AddImage(image);

// 向幻灯片添加图片框
SharedPtr<IPictureFrame> pf = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50, 50, 100, 100, imgx);

// 设置相对比例的宽度和高度
pf->set_RelativeScaleHeight (0.8);
pf->set_RelativeScaleWidth(1.35);

// 将 PPTX 文件写入磁盘
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

Tip

Aspose 最近推出了一个免费拼图制作工具。如果您需要合并 JPG/JPEG 或 PNG 图像，或从照片创建网格，可以使用此服务。

将图像作为链接添加

为避免演示文稿体积过大，您可以通过链接而非直接嵌入文件的方式添加图像（或视频）。以下 C++ 代码演示了如何向占位符中添加图像和视频：

auto presentation = System::MakeObject<Presentation>(u"input.pptx");
auto shapesToRemove = System::MakeObject<System::Collections::Generic::List<System::SharedPtr<IShape>>>();
auto shapes = presentation->get_Slides()->idx_get(0)->get_Shapes();

for (auto& autoShape : shapes)
{
    if (autoShape->get_Placeholder() == nullptr)
        continue;

    switch (autoShape->get_Placeholder()->get_Type())
    {
        case Aspose::Slides::PlaceholderType::Picture:
        {
            auto pictureFrame = shapes->AddPictureFrame(Aspose::Slides::ShapeType::Rectangle, autoShape->get_X(), autoShape->get_Y(), autoShape->get_Width(), autoShape->get_Height(), nullptr);
            pictureFrame->get_PictureFormat()->get_Picture()->set_LinkPathLong(u"https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");
            shapesToRemove->Add(autoShape);
            break;
        }

        case Aspose::Slides::PlaceholderType::Media:
        {
            auto videoFrame = shapes->AddVideoFrame(autoShape->get_X(), autoShape->get_Y(), autoShape->get_Width(), autoShape->get_Height(), u"");
            videoFrame->get_PictureFormat()->get_Picture()->set_LinkPathLong(u"https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");
            videoFrame->set_LinkPathLong(u"https://youtu.be/t_1LYZ102RA");
            shapesToRemove->Add(autoShape);
            break;
        }
    }
}

for (auto& shape : shapesToRemove)
{
    shapes->Remove(shape);
}

presentation->Save(u"output.pptx", Aspose::Slides::Export::SaveFormat::Pptx);

裁剪图像

以下 C++ 代码演示了如何裁剪幻灯片上的现有图像：

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System::Drawing;
    
auto presentation = System::MakeObject<Presentation>();
// 创建新的图像对象
auto newImage = presentation->get_Images()->AddImage(Images::FromFile(imagePath));

// 向幻灯片添加图片框
auto picFrame = presentation->get_Slides()->idx_get(0)->get_Shapes()->AddPictureFrame(Aspose::Slides::ShapeType::Rectangle, 100.0f, 100.0f, 420.0f, 250.0f, newImage);

// 裁剪图像（百分比值）
picFrame->get_PictureFormat()->set_CropLeft(23.6f);
picFrame->get_PictureFormat()->set_CropRight(21.5f);
picFrame->get_PictureFormat()->set_CropTop(3.0f);
picFrame->get_PictureFormat()->set_CropBottom(31.0f);

// 保存结果
presentation->Save(outPptxFile, Aspose::Slides::Export::SaveFormat::Pptx);

删除图片框的裁剪区域

如果您想删除框中图像的裁剪区域，可使用 IPictureFillFormat::DeletePictureCroppedAreas() 方法。若不需要裁剪，该方法返回原始图像。

以下 C++ 代码演示了此操作：

System::SharedPtr<Presentation> presentation = System::MakeObject<Presentation>(u"PictureFrameCrop.pptx");
System::SharedPtr<ISlide> slide = presentation->get_Slide(0);

// 从第一张幻灯片获取 PictureFrame
System::SharedPtr<IPictureFrame> picFrame = System::AsCast<IPictureFrame>(slide->get_Shape(0));

// 删除 PictureFrame 图像的裁剪区域并返回裁剪后的图像
System::SharedPtr<IPPImage> croppedImage = picFrame->get_PictureFormat()->DeletePictureCroppedAreas();

// 保存结果
presentation->Save(u"PictureFrameDeleteCroppedAreas.pptx", SaveFormat::Pptx);

NOTE

IPictureFillFormat::DeletePictureCroppedAreas() 方法会将裁剪后的图像添加到演示文稿的图像集合中。如果该图像仅用于已处理的 PictureFrame，此设置可以减小演示文稿大小；否则，生成的演示文稿中的图像数量会增加。

该方法在裁剪操作中会将 WMF/EMF 元文件转换为光栅 PNG 图像。

锁定宽高比

若希望包含图像的形状在更改图像尺寸后仍保持宽高比，可使用 set_AspectRatioLocked() 方法设置 锁定宽高比。

以下 C++ 代码演示了如何锁定形状的宽高比：

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

System::SharedPtr<ILayoutSlide> layout = pres->get_LayoutSlides()->GetByType(SlideLayoutType::Custom);
System::SharedPtr<ISlide> emptySlide = pres->get_Slides()->AddEmptySlide(layout);

System::SharedPtr<IImage> image = Images::FromFile(u"image.png");
System::SharedPtr<IPPImage> presImage = pres->get_Images()->AddImage(image);

System::SharedPtr<IPictureFrame> pictureFrame = emptySlide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50.0f, 150.0f, static_cast<float>(presImage->get_Width()), static_cast<float>(presImage->get_Height()), presImage);

// set shape to have to preserve aspect ratio on resizing
pictureFrame->get_PictureFrameLock()->set_AspectRatioLocked(true);

NOTE

此 锁定宽高比 设置仅保留形状本身的宽高比，而不影响其包含的图像。

使用 StretchOff 属性

通过使用 IPictureFillFormat 接口和 PictureFillFormat 类中的 StretchOffsetLeft、StretchOffsetTop、StretchOffsetRight 和 StretchOffsetBottom 属性，您可以指定填充矩形。

当指定图像拉伸时，源矩形会按比例缩放以适应指定的填充矩形。填充矩形的每条边由相对于形状边界框对应边缘的百分比偏移定义。正百分比表示向内收缩，负百分比表示向外延伸。

创建一个 Presentation 类的实例。
通过索引获取幻灯片的引用。
添加一个矩形 AutoShape。
创建图像。
设置形状的填充类型。
设置形状的图片填充模式。
添加用于填充形状的设置图像。
指定图像相对于形状边界框相应边缘的偏移。
将修改后的演示文稿写入为 PPTX 文件。

下面的 C++ 代码演示了使用 StretchOff 属性的过程：

auto pres = System::MakeObject<Presentation>();
auto ppImage = pres->get_Images()->AddImage(Images::FromFile(u"image.png"));
auto slide = pres->get_Slide(0);
auto pictureFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 10.0f, 10.0f, 400.0f, 400.0f, ppImage);

// Sets the image stretched from each side in the shape body
auto pictureFormat = pictureFrame->get_PictureFormat();
pictureFormat->set_PictureFillMode(PictureFillMode::Stretch);
pictureFormat->set_StretchOffsetLeft(24.0f);
pictureFormat->set_StretchOffsetRight(24.0f);
pictureFormat->set_StretchOffsetTop(24.0f);
pictureFormat->set_StretchOffsetBottom(24.0f);

pres->Save(u"imageStretch.pptx", SaveFormat::Pptx);

FAQ

如何查看 PictureFrame 支持的图像格式？
Aspose.Slides 通过分配给 PictureFrame 的图像对象支持光栅图像（PNG、JPEG、BMP、GIF 等）和矢量图像（例如 SVG）。支持的格式列表通常与幻灯片和图像转换引擎的功能相重叠。

大量大图像会如何影响 PPTX 大小和性能？
嵌入大图像会增加文件大小和内存占用；使用链接图像可降低演示文稿大小，但需确保外部文件始终可访问。Aspose.Slides 提供通过链接添加图像的功能以减小文件体积。

如何防止图像对象被意外移动/缩放？
对 PictureFrame 使用 shape locks（例如禁用移动或缩放）。锁定机制在单独的保护文章中介绍，适用于包括 PictureFrame 在内的多种形状类型。

导出演示文稿为 PDF/图像时，SVG 矢量保真度是否得以保留？
Aspose.Slides 允许从 PictureFrame 中提取 SVG 作为原始矢量图。当导出为 PDF 或光栅格式时，结果可能会根据导出设置被光栅化；提取行为验证了原始 SVG 仍以矢量形式存储。