Aspose.Slides for PHP via Java 14.5.0 的公共 API 和向后不兼容更改
公共 API 和向后不兼容更改
添加的类和方法
添加了 Aspose.Slides.IPresentationInfo 接口和 PresentationInfo 类
表示关于演示文稿的信息。
方法 Boolean isEncrypted() 如果演示文稿是加密的，则返回 True，否则返回 False。
方法 LoadFormat getLoadFormat() 获取演示文稿类型。
添加了 Aspose.Slides.IShape.isGrouped() 方法
方法 Aspose.Slides.IShape.isGrouped() 确定形状是否被分组。
添加了 Aspose.Slides.IShape.getParentGroup() 方法
方法 Aspose.Slides.IShape.getParentGroup() 如果形状被分组，则返回父 GroupShape 对象。否则返回 null。
添加了 Aspose.Slides.IShapeCollection.addGroupShape() 方法
方法 Aspose.Slides.IShapeCollection.addGroupShape() 创建一个新的 GroupShape 并将其添加到集合的末尾。
当将新形状添加到 GroupShape 时，GroupShape 的框架大小和位置将适应内容。
添加了 Aspose.Slides.IShapeCollection.clear() 方法
方法 Aspose.Slides.IShapeCollection.clear() 从集合中移除所有形状。
添加了 Aspose.Slides.IShapeCollection.insertGroupShape(int) 方法
方法 Aspose.Slides.IShapeCollection.insertGroupShape(int) 创建一个新的 GroupShape 并将其插入到指定索引的集合中。 当将新形状添加到 GroupShape 时，GroupShape 的框架大小和位置将适应内容。
添加了 IPresentationFactory.getPresentationInfo(string file)、IPresentatoinFactory.getPresentationInfo(InputStream stream) 方法
这些方法允许开发人员在不完全加载演示文稿的情况下接收关于演示文稿文件/流的信息。
添加了 IPresentationFactory PresentationFactory.getInstance() 方法
允许在不实例化的情况下使用工厂功能。
限制
对使用未定义值进行 IShape.getFrame() 添加了限制
尝试为 IShape.setFrame(IShapeFrame) 分配未定义框架的代码在一般情况下没有意义（特别是在父 GroupShape 多重嵌套到其他 {{GroupShape}} 中时）。例如：
$shape = $$missing$;
$shape->setFrame(new ShapeFrame(Float::NaN, Float::NaN, Float::NaN, Float::NaN, NullableBool::NotDefined, NullableBool::NotDefined, Float::NaN));
或
slide.Shapes->AddAutoShape(ShapeType::RoundCornerRectangle, Float::NaN, Float::NaN, Float::NaN, Float::NaN);
这样的代码可能导致不明确的情况。因此，添加了对使用未定义值进行 IShape.Frame 的限制。x、y、width、height、flipH、flipV 和 rotationAngle 的值必须被定义（不能为 Float.NaN 或 NullableBool.NotDefined）。上述示例代码现在抛出 ArgumentException 异常。 这适用于这些使用案例：
$shape = $$missing$;
$shape->setFrame();// 不能是未定义的
$shapes = $$missing$;
# x, y, width, height 参数不能为 Float.NaN：
{
$shapes->addAudioFrameCD();
$shapes->addAudioFrameEmbedded();
$shapes->addAudioFrameLinked();
$shapes->addAutoShape();
$shapes->addChart();
$shapes->addConnector();
$shapes->addOleObjectFrame();
$shapes->addPictureFrame();
$shapes->addSmartArt();
$shapes->addTable();
$shapes->addVideoFrame();
$shapes->insertAudioFrameEmbedded();
$shapes->insertAudioFrameLinked();
$shapes->insertAutoShape();
$shapes->insertChart();
$shapes->insertConnector();
$shapes->insertOleObjectFrame();
$shapes->insertPictureFrame();
$shapes->insertTable();
$shapes->insertVideoFrame();
}
但 IShape.getRawFrame() 框架可以是未定义的。当形状链接到占位符时，这是有意义的。然后未定义的形状框架值会从父占位符形状覆盖。如果该形状没有父占位符形状，则在根据其 IShape.getRawFrame() 评估有效框架时将使用默认值。默认值为 x、y、width、height、flipH、flipV 和 rotationAngle 的值为 0 和 NullableBool.False。例如：
$shape = $$missing$;// 形状链接到占位符
$shape->setRawFrame(new ShapeFrame(Float::NaN, Float::NaN, 100, Float::NaN, NullableBool::NotDefined, NullableBool::NotDefined, 0));
# 现在形状继承占位符的 x、y、高度、flipH、flipV 值，并将 width=100 和 rotationAngle=0 覆盖。
更改的属性
Aspose.Slides.IShapeCollection.getParent() 方法的类型和名称已更改
Aspose.Slides.IShapeCollection.Parent 属性的类型已从 ISlideComponent 更改为新的 IGroupShape 接口。IGroupShape 接口是 ISlideComponent 的子类，因此现有代码无需适应。
Aspose.Slides.IShapeCollection.getParent() 方法的名称已从 getParent 更改为 getParentGroup()。
Aspose.Slides.IShapeFrame.getFlipH() 和 .getFlipV() 方法的类型已更改
Aspose.Slides.IShapeFrame.getFlipH() 方法的类型已从 bool 更改为 NullableBool。
IShape.getFrame() 方法返回 IShapeFrame 的有效实例（所有属性都有定义的有效值）。
IShape.getRawFrame() 方法返回一个 IShapeFrame 实例，其中每个属性可以有未定义值（特别是 FlipH 或 FlipV 可以有值 NullableBool.NotDefined）。