Aspose.Slides for PHP via Java 14.9.0 中的公共 API 和不兼容的变更

本页面列出了与 Aspose.Slides for PHP via Java 14.9.0 API 一起引入的所有 添加的 类、方法、属性等、任何新的限制和其他 变更。

公共 API 变更

为 PPImage, IPPImage 添加的替换图像方法

新增的方法：

• IPPImage.replaceImage(byte[] newImageData)
• IPPImage.replaceImage(IPPImage newImage)

  $presentation = new Presentation("presentation.pptx");
  # 第一个方法
  # ...
  $imageData = $presentation->getImages()->get_Item(0)->replaceImage($imageData);
  # 第二个方法
  $presentation->getImages()->get_Item(1)->replaceImage($presentation->getImages()->get_Item(0));
  $presentation->save("presentation_out.pptx", SaveFormat::Pptx);

为保存幻灯片保留页码而添加的方法

添加了以下方法：

• void IPresentation.save(string fname, int[] slides, SaveFormat format);
• void IPresentation.save(string fname, int[] slides, SaveFormat format, ISaveOption options);
• void IPresentation.save(Stream stream, int[] slides, SaveFormat format);
• void IPresentation.save(Stream stream, int[] slides, SaveFormat format, ISaveOption options);

这些方法允许将指定的演示文稿幻灯片保存为 PDF、XPS、TIFF、HTML 格式。“slides”数组允许指定页码，从 1 开始。

  save($string, $slides, SaveFormat);

  $presentation = new Presentation($presentationFileName);
  $slides = array(2, 3, 5 );// 幻灯片位置数组

  $presentation->save($outFileName, $slides, SaveFormat::Pdf);

添加了 SmartArtLayoutType::Custom 枚举值

此类型的 SmartArt 布局表示具有自定义模板的图表。自定义图表只能从演示文稿文件中加载，无法通过方法 ShapeCollection.addSmartArt(x, y, width, height, SmartArtLayoutType::Custom) 创建。

添加了 SmartArtShape 类和 ISmartArtShape 接口

Aspose.Slides.SmartArt.SmartArtShape 类（及其接口 Aspose.Slides.SmartArt.ISmartArtShape）提供对 SmartArt 图表中单个形状的访问。SmartArtShape 可用于更改 FillFormat、LineFormat、添加超链接等。

SmartArtShape 不支持 IShape 属性 RawFrame、Frame、Rotation、X、Y、Width、Height，并在尝试访问它们时抛出 System.NotSupportedException。

使用示例：

  $pres = new Presentation();
  $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::BasicBlockList);
  $node = $smart->getAllNodes()->get_Item(0);
  foreach($node->getShapes() as $shape) {
    $shape->getFillFormat()->setFillType(FillType::Solid);
    $shape->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
  }
  $pres->save("out.pptx", SaveFormat::Pptx);

添加了 SmartArtShapeCollection 类、ISmartArtShapeCollection 接口和 ISmartArtNode.getShapes() 方法

Aspose.Slides.SmartArt.SmartArtShapeCollection 类（及其接口 Aspose.Slides.SmartArt.ISmartArtShapeCollection）提供对 SmartArt 图表中单个形状的访问。集合包含与 SmartArtNode 相关联的形状。属性 SmartArtNode.Shapes 返回与节点相关联的所有形状的集合。

根据 SmartArtLayoutType，一个 SmartArtShape 可以在多个节点之间共享。

  $pres = new Presentation();
  $smart = $pres->getSlides()->get_Item(0)->getShapes()->addSmartArt(10, 10, 400, 300, SmartArtLayoutType::BasicBlockList);
  $node = $smart->getAllNodes()->get_Item(0);
  foreach($node->getShapes() as $shape) {
    $shape->getFillFormat()->setFillType(FillType::Solid);
    $shape->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
  }
  $pres->save("out.pptx", SaveFormat::Pptx);