Публичный API и несовместимые изменения в Aspose.Slides для Java 14.5.0

Эта страница содержит список всех добавленных классов, методов, свойств и так далее, любых новых ограничений и других изменений, введенных в API Aspose.Slides для Java 14.5.0.

Публичный 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), IPresentationFactory.getPresentationInfo(InputStream stream)

Эти методы позволяют разработчикам получать информацию о файле/потоке презентации без полной загрузки презентации.

Добавлен метод IPresentationFactory PresentationFactory.getInstance()

Позволяет использовать функциональность фабрики без инстанцирования.

Ограничения

Добавлены ограничения на использование не определенных значений для IShape.getFrame()

Код, который пытается присвоить неопределенную рамку IShape.setFrame(IShapeFrame), не имеет смысла в общем случае (особенно когда родительская GroupShape многократно вложена в другие {{GroupShape}}). Например:


 IShape shape = ...;

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. Это относится к следующим случаям использования:


 IShape shape = ...;

shape.setFrame(...); // не может быть неопределенным

IShapeCollection shapes = ...;

// параметры 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(). Значения по умолчанию - это 0 и NullableBool.False для x, y, width, height, flipH, flipV и rotationAngle. Например:


 IShape shape = ...; // фигура связана с заполнительом

shape.setRawFrame(new ShapeFrame(Float.NaN, Float.NaN, 100, Float.NaN, NullableBool.NotDefined, NullableBool.NotDefined, 0));

// теперь фигура унаследует значения x, y, height, 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).

Как создать диаграммы в презентации Публичный API и изменения, несовместимые с предыдущими версиями в Aspose.Slides для Java 14.6.0