Aspose.Slides for Java 14.9.0 的公共 API 與向後不相容變更
Contents
[
Hide
]
公共 API 變更
已加入用於將圖像替換為 PPImage、IPPImage 的方法
新增的方法如下：
- IPPImage.replaceImage(byte[] newImageData)
- IPPImage.replaceImage(IPPImage newImage)
Presentation presentation = new Presentation("presentation.pptx");
//第一種方式
byte[] 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 fname, int\[\] slides, SaveFormat format);
Presentation presentation = new Presentation(presentationFileName);
int[] slides = new int[] { 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。
使用範例：
Presentation pres = new Presentation();
ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);
ISmartArtNode node = smart.getAllNodes().get_Item(0);
for (ISmartArtShape shape : node.getShapes())
{
shape.getFillFormat().setFillType(FillType.Solid);
shape.getFillFormat().getSolidFillColor().setColor(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 可能會被多個節點共享。
Presentation pres = new Presentation();
ISmartArt smart = pres.getSlides().get_Item(0).getShapes().addSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);
ISmartArtNode node = smart.getAllNodes().get_Item(0);
for (ISmartArtShape shape : node.getShapes())
{
shape.getFillFormat().setFillType(FillType.Solid);
shape.getFillFormat().getSolidFillColor().setColor(Color.RED);
}
pres.save("out.pptx", SaveFormat.Pptx);