Aspose.Slides for .NET 14.9.0 的公共 API 和向后不兼容的更改

此页面列出所有已已添加或已已删除的类、方法、属性等，以及 Aspose.Slides for .NET 14.9.0 API 引入的其他更改。

公共 API 更改

已在 ISmartArtNodeCollection 中添加对 ICollection 和通用 IEnumerable 接口的继承

类 Aspose.Slides.SmartArt.SmartArtNodeCollection（以及相关接口 Aspose.Slides.SmartArt.ISmartArtNodeCollection）继承通用接口 IEnumerable 和接口 ICollection。

已添加 SmartArtLayoutType.Custom 枚举值

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。

使用示例：

using (Presentation pres = new Presentation())
{
  ISmartArt smart = pres.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);
  ISmartArtNode node = smart.AllNodes[0];
  foreach (SmartArtShape shape in node.Shapes)
  {
    shape.FillFormat.FillType = FillType.Solid;
    shape.FillFormat.SolidFillColor.Color = Color.Red;
  }
  pres.Save("out.pptx", Export.SaveFormat.Pptx);
}

已添加 SmartArtShapeCollection 类、ISmartArtShapeCollection 接口以及 ISmartArtNode.Shapes 属性

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

注意：根据 SmartArtLayoutType，不同节点之间可能共享同一个 SmartArtShape。

using (Presentation pres = new Presentation())
{
  ISmartArt smart = pres.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);
  ISmartArtNode node = smart.AllNodes[0];
  foreach (SmartArtShape shape in node.Shapes)
  {
    shape.FillFormat.FillType = FillType.Solid;
    shape.FillFormat.SolidFillColor.Color = Color.Red;
  }
  pres.Save("out.pptx", Export.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);

已添加用于替换图像的方法到 PPImage、IPPImage

新增方法：

• IPPImage.ReplaceImage(byte[] newImageData)
• IPPImage.ReplaceImage(Image newImage)
• IPPImage.ReplaceImage(IPPImage newImage)

Presentation presentation = new Presentation(presentation.pptx);
// 第一次方法
byte[] data = File.ReadAllBytes(image0.jpeg);
IPPImage oldImage = presentation.Images[0];
oldImage.ReplaceImage(data);
// 第二次方法
Image newImage = Image.FromFile(image1.png);
oldImage = presentation.Images[1];
oldImage.ReplaceImage(newImage);
// 第三次方法
oldImage = presentation.Images[2];
oldImage.ReplaceImage(presentation.Images[3]);
presentation.Save(presentation_out.pptx, SaveFormat.Pptx);