Aspose.Slides for Android via Java 21.4 Release Notes
| Key | Summary | Category |
|---|---|---|
| SLIDESANDROID-325 | Use Aspose.Slides for Java 21.4 features | Enhancement |
Public API Changes
IAudioFrame.getPlayAcrossSlides, IAudioFrame.setPlayAcrossSlides, IAudioFrame.setRewindAudio and IAudioFrame.getRewindAudio methods have been added
New methods IAudioFrame.getPlayAcrossSlides, IAudioFrame.setPlayAcrossSlides, IAudioFrame.getRewindAudio and IAudioFrame.setRewindAudio have been added to the IAudioFrame interface and AudioFrame class.
The IAudioFrame.getPlayAcrossSlides and IAudioFrame.setPlayAcrossSlides methods allows determining whether audio is playing across the slides.
Methods declaration:
/**
* <p>
* Determines whether audio is playing across the slides.
* Read/write {@code boolean}.
* </p>
*/
public final boolean getPlayAcrossSlides()
/**
* <p>
* Determines whether audio is playing across the slides.
* Read/write {@code boolean}.
* </p>
*/
public final void setPlayAcrossSlides(boolean value)
The IAudioFrame.getRewindAudio and IAudioFrame.setRewindAudio methods allows determining whether audio is automatically rewinded to start after playing.
Methods declaration:
/**
* <p>
* Determines whether audio is automatically rewinded to start after playing.
* Read/write {@code boolean}.
* </p>
*/
public final boolean getRewindAudio()
/**
* <p>
* Determines whether audio is automatically rewinded to start after playing.
* Read/write {@code boolean}.
* </p>
*/
public final void setRewindAudio(boolean value)
The code snippet below demonstrates adding the AudioFrame and changing its properties:
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
// Add Audio Frame
IAudioFrame audioFrame = slide.getShapes().addAudioFrameLinked(50, 50, 100, 100, "sampleaudio.wav");
// Set Audio to play across the slides
audioFrame.setPlayAcrossSlides(true);
// Set Audio to automatically rewind to start after playing
audioFrame.setRewindAudio(true);
pres.save("AudioFrame_out.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
InClickSequence value has been added to AudioPlayModePreset enumeration
InClickSequence value has been added to AudioPlayModePreset enumeration. It represents In Click Sequence audio start play mode.
The code snippet below demonstrates adding the AudioFrame and changing its play mode:
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
// Add Audio Frame
IAudioFrame audioFrame = slide.getShapes().addAudioFrameLinked(50, 50, 100, 100, "sampleaudio.wav");
// Set audio play mode to In Click Sequence
audioFrame.setPlayMode(AudioPlayModePreset.InClickSequence);
pres.save("AudioFrame_out.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
InClickSequence value has been added to VideoPlayModePreset enumeration
InClickSequence value has been added to VideoPlayModePreset enumeration. It represents In Click Sequence video start play mode.
The code snippet below demonstrates adding the VideoFrame and changing its play mode:
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
// Add Video Frame
IVideoFrame videoFrame = slide.getShapes().addVideoFrame(50, 50, 200, 150, "samplevideo.wmv");
// Set video play mode to In Click Sequence
videoFrame.setPlayMode(VideoPlayModePreset.InClickSequence);
pres.save("VideoFrame_out.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
IOleObjectFrame.setEmbeddedData and IOleObjectFrame.getEmbeddedData methods have been added
New methods setEmbeddedData and getEmbeddedData have been added to the IOleObjectFrame interface and OleObjectFrame class.
These methods allow to get, set and change an embedded data and its type of OLE object.
Method declaration:
/**
* <p>
* Gets information about OLE embedded data.
* Read only {@link IOleEmbeddedDataInfo}.
* </p>
*/
public IOleEmbeddedDataInfo getEmbeddedData()
Method declaration:
/**
* <p>
* Sets information about OLE embedded data.
* </p>
*/
public void setEmbeddedData(IOleEmbeddedDataInfo embeddedData);
The code snippet below demonstrates getting and changing OLE embedded data in existing OLE object:
Presentation pres = new Presentation("pres.pptx");
try {
OleObjectFrame oleFrame = null;
// Get first slide of a presentation
ISlide slide = pres.getSlides().get_Item(0);
// Traversing all shapes for OLE frame
for (IShape shape : slide.getShapes()) {
if (shape instanceof OleObjectFrame) {
oleFrame = (OleObjectFrame) shape;
}
}
if (oleFrame != null) {
// Create a file name with type of an embedded data
String embeddedFile = "EmbeddedData." + oleFrame.getEmbeddedData().getEmbeddedFileExtension();
// Save embedded data to a file
Files.write(Paths.get(embeddedFile), oleFrame.getEmbeddedData().getEmbeddedFileData());
// Create new data for embedding in OLE object
byte[] data = Files.readAllBytes(Paths.get("book1.xlsx"));
IOleEmbeddedDataInfo newData = new OleEmbeddedDataInfo(data, "xlsx");
// Change embedding data in OleObjectFrame
oleFrame.setEmbeddedData(newData);
}
pres.save("OleEdit_out.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
if (pres != null) pres.dispose();
}
Please note that methods getObjectData, getEmbeddedFileExtension and getEmbeddedFileData of IOleObjectFrame interface marked as obsolete now so please use IOleObjectFrame.setEmbeddedData and IOleObjectFrame.getEmbeddedData methods instead of them. These obsolete methods will be removed after the release of version 21.11.
New overloadings for the SlideUtil.alignShapes method have been added
Method SlideUtil.alignShapes(ShapesAlignmentType alignmentType, boolean alignToSlide, IBaseSlide slide) has been added.
This overloading allows aligning all shapes within IBaseSlide.
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
IAutoShape shape1 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 100, 100);
IAutoShape shape2 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 100, 100);
IAutoShape shape3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 300, 300, 100, 100);
SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, true, pres.getSlides().get_Item(0));
pres.save("output.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Method SlideUtil.alignShapes(ShapesAlignmentType alignmentType, boolean alignToSlide, IGroupShape shapes) has been added.
This overloading allows aligning all shapes within IGroupShape.
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
IGroupShape groupShape = slide.getShapes().addGroupShape();
groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 350, 50, 50, 50);
groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 450, 150, 50, 50);
groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 550, 250, 50, 50);
groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 650, 350, 50, 50);
SlideUtil.alignShapes(ShapesAlignmentType.AlignLeft, false, groupShape);
pres.save("output.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}
Method SlideUtil.alignShapes(ShapesAlignmentType alignmentType, boolean alignToSlide, IGroupShape shapes, int[] shapeIndexes) has been added.
This overloading allows aligning shapes with specified indexes within IGroupShape.
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
IGroupShape groupShape = slide.getShapes().addGroupShape();
groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 350, 50, 50, 50);
groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 450, 150, 50, 50);
groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 550, 250, 50, 50);
groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 650, 350, 50, 50);
SlideUtil.alignShapes(ShapesAlignmentType.AlignLeft, false, groupShape, new int[] { 0, 2 });
pres.save("output.pptx", SaveFormat.Pptx);
} finally {
if (pres != null) pres.dispose();
}