IShapeCollection

All Implemented Interfaces: com.aspose.slides.IGenericCollection

public interface IShapeCollection extends IGenericCollection<IShape>

Represents a collection of shapes.

Methods

Method	Description
get_Item(int index)	Gets the element at the specified index.
getParentGroup()	Gets the parent group shape object for the shapes collection.
addChart(int type, float x, float y, float width, float height)	Creates a new chart, initializes it with sample series data and settings, and adds it to the end of the shape collection.
addChart(int type, float x, float y, float width, float height, boolean initWithSample)	Creates a new chart, initializes it with sample series data and settings, and adds it to the end of the shape collection.
addSmartArt(float x, float y, float width, float height, int layoutType)	Creates a SmartArt diagram and adds it to the end of the shape collection.
insertChart(int type, float x, float y, float width, float height, int index)	Creates a new chart, initializes it with sample series data and settings, and inserts it into the shape collection at the specified index.
insertChart(int type, float x, float y, float width, float height, int index, boolean initWithSample)	Creates a new chart, initializes it with sample series data and settings, and inserts it into the shape collection at the specified index.
addOleObjectFrame(float x, float y, float width, float height, IOleEmbeddedDataInfo dataInfo)	Creates a new OLE object frame and adds it to the end of the shape collection.
addOleObjectFrame(float x, float y, float width, float height, String className, String path)	Creates a new OLE object frame and adds it to the end of the shape collection.
insertOleObjectFrame(int index, float x, float y, float width, float height, IOleEmbeddedDataInfo dataInfo)	Creates a new OLE object frame and inserts it into the shape collection at the specified index.
insertOleObjectFrame(int index, float x, float y, float width, float height, String className, String path)	Creates a new OLE object frame and inserts it into the shape collection at the specified index.
addZoomFrame(float x, float y, float width, float height, ISlide slide)	Creates a new Zoom frame and adds it to the end of the shape collection.
addZoomFrame(float x, float y, float width, float height, ISlide slide, IPPImage image)	Creates a new Zoom frame and adds it to the end of the shape collection.
insertZoomFrame(int index, float x, float y, float width, float height, ISlide slide)	Creates a new Zoom frame and inserts it into the shape collection at the specified index.
insertZoomFrame(int index, float x, float y, float width, float height, ISlide slide, IPPImage image)	Creates a new Zoom frame with a predefined image and inserts it into the shape collection at the specified index.
addSectionZoomFrame(float x, float y, float width, float height, ISection section)	Creates a new Section Zoom frame and adds it to the end of the shape collection.
addSectionZoomFrame(float x, float y, float width, float height, ISection section, IPPImage image)	Creates a new Section Zoom frame with a predefined image and adds it to the end of the shape collection.
insertSectionZoomFrame(int index, float x, float y, float width, float height, ISection section)	Creates a new Section Zoom frame and inserts it into to the shape collection at the specified index.
insertSectionZoomFrame(int index, float x, float y, float width, float height, ISection section, IPPImage image)	Creates a new Section Zoom frame with a predefined image and inserts it into to the shape collection at the specified index.
addSummaryZoomFrame(float x, float y, float width, float height)	Creates a new Summary Zoom frame and adds it to the end of the shape collection.
insertSummaryZoomFrame(int index, float x, float y, float width, float height)	Creates a new Summary Zoom frame and inserts it into the shape collection at the specified index.
addVideoFrame(float x, float y, float width, float height, String fname)	Creates a new video frame and adds it to the end of the shape collection.
addVideoFrame(float x, float y, float width, float height, IVideo video)	Creates a new video frame and adds it to the end of the shape collection.
insertVideoFrame(int index, float x, float y, float width, float height, String fname)	Creates a new video frame and inserts it into the shape collection at the specified index.
addAudioFrameCD(float x, float y, float width, float height)	Creates a new audio frame linked to a CD track and adds it to the end of the shape collection.
insertAudioFrameCD(int index, float x, float y, float width, float height)	Creates a new audio frame linked to a CD track and inserts it into the shape collection at the specified index.
addAudioFrameLinked(float x, float y, float width, float height, String fname)	Creates a new audio frame linked to an external audio file and adds it to the end of the shape collection.
insertAudioFrameLinked(int index, float x, float y, float width, float height, String fname)	Creates a new audio frame linked to an external audio file and inserts it into the shape collection at the specified index.
addAudioFrameEmbedded(float x, float y, float width, float height, InputStream audio_stream)	Creates a new audio frame with an embedded WAV file and adds it to the end of the shape collection.
addAudioFrameEmbedded(float x, float y, float width, float height, IAudio audio)	Creates a new audio frame and adds it to the end of the shape collection using an existing audio object from the Presentation.Audios list.
insertAudioFrameEmbedded(int index, float x, float y, float width, float height, InputStream audio_stream)	Creates a new audio frame with an embedded WAV file and inserts it into the shape collection at the specified index.
insertAudioFrameEmbedded(int index, float x, float y, float width, float height, IAudio audio)	Creates a new audio frame and inserts it into the shape collection at the specified index using an existing audio object from the Presentation.Audios list.
indexOf(IShape shape)	Returns the zero-based index of the first occurrence of the specified shape in the collection.
toArray()	Creates and returns an array that contains all shapes.
toArray(int startIndex, int count)	Creates and returns an array that contains all shapes in the specified range.
reorder(int index, IShape shape)	Moves the specified shape to a new position within the shape collection.
reorder(int index, IShape[] shapes)	Moves the specified shapes within the shape collection, placing them starting at the given index.
addAutoShape(int shapeType, float x, float y, float width, float height)	Creates a new auto shape with default formatting and adds it to the end of the shape collection.
addAutoShape(int shapeType, float x, float y, float width, float height, boolean createFromTemplate)	Creates a new auto shape and adds it to the end of the shape collection, optionally initializing it with default template formatting.
addMathShape(float x, float y, float width, float height)	Creates a new rectangle auto shape to host mathematical content and adds it to the end of the shape collection.
insertAutoShape(int index, int shapeType, float x, float y, float width, float height)	Creates a new auto shape and inserts it into the shape collection at the specified index, applying default template formatting.
insertAutoShape(int index, int shapeType, float x, float y, float width, float height, boolean createFromTemplate)	Creates a new auto shape and inserts it into the shape collection at the specified index, optionally initializing it with default template styling.
addGroupShape()	Creates a new empty group shape and adds it to the end of the shape collection.
addGroupShape(ISvgImage svgImage, float x, float y, float width, float height)	Creates a new group shape, converts the specified SVG image into individual shapes, and adds the resulting group to the end of the shape collection.
insertGroupShape(int index)	Creates a new empty group shape and inserts it to the shape collection at the specified index.
addConnector(int shapeType, float x, float y, float width, float height)	Creates a new connector shape with default template styling and adds it to the end of the shape collection.
addConnector(int shapeType, float x, float y, float width, float height, boolean createFromTemplate)	Creates a new connector shape and adds it to the end of the shape collection, optionally applying default template styling.
insertConnector(int index, int shapeType, float x, float y, float width, float height)	Creates a new connector shape and inserts it into the shape collection at the specified index, applying default template styling.
insertConnector(int index, int shapeType, float x, float y, float width, float height, boolean createFromTemplate)	Creates a new connector shape and inserts it into the shape collection at the specified index, optionally applying default template styling.
addPictureFrame(int shapeType, float x, float y, float width, float height, IPPImage image)	Creates a new picture frame containing the specified image and adds it to the end of the shape collection.
insertPictureFrame(int index, int shapeType, float x, float y, float width, float height, IPPImage image)	Creates a new picture frame containing the specified image and inserts it into the shape collection at the specified index.
addTable(float x, float y, double[] columnWidths, double[] rowHeights)	Creates a new table and adds it to the end of the shape collection.
insertTable(int index, float x, float y, double[] columnWidths, double[] rowHeights)	Creates a new table and inserts it into the shape collection at the specified index.
removeAt(int index)	Removes the shape at the specified index from the shape collection.
remove(IShape shape)	Removes the first occurrence of the specified shape from the shape collection.
clear()	Removes all shapes from the shape collection.
addClone(IShape sourceShape, float x, float y, float width, float height)	Creates a copy of the specified shape and adds it to the end of the shape collection.
addClone(IShape sourceShape, float x, float y)	Creates a copy of the specified shape and adds it to the end of the shape collection.
addClone(IShape sourceShape)	Creates a copy of the specified shape and adds it to the end of the shape collection.
insertClone(int index, IShape sourceShape, float x, float y, float width, float height)	Creates a copy of the specified shape and inserts it into the shape collection at the specified index.
insertClone(int index, IShape sourceShape, float x, float y)	Creates a copy of the specified shape and inserts it into the shape collection at the specified index.
insertClone(int index, IShape sourceShape)	Creates a copy of the specified shape and inserts it into the shape collection at the specified index.

get_Item(int index)

public abstract IShape get_Item(int index)

Gets the element at the specified index. Read-only IShape.

Parameters:

Parameter	Type	Description
index	int

Returns: IShape

getParentGroup()

public abstract IGroupShape getParentGroup()

Gets the parent group shape object for the shapes collection. Read-only IGroupShape.

Returns: IGroupShape

addChart(int type, float x, float y, float width, float height)

public abstract IChart addChart(int type, float x, float y, float width, float height)

Creates a new chart, initializes it with sample series data and settings, and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
type	int	The type of chart to add.
x	float	The x-coordinate of the new chart, in points.
y	float	The y-coordinate of the new chart, in points.
width	float	The width of the chart, in points.
height	float	The height of the chart, in points.

Returns: IChart - The newly created IChart.

addChart(int type, float x, float y, float width, float height, boolean initWithSample)

public abstract IChart addChart(int type, float x, float y, float width, float height, boolean initWithSample)

Creates a new chart, initializes it with sample series data and settings, and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
type	int	The type of chart to add.
x	float	The x-coordinate of the new chart, in points.
y	float	The y-coordinate of the new chart, in points.
width	float	The width of the chart, in points.
height	float	The height of the chart, in points.
initWithSample	boolean	True to initialize the new chart with sample series data and settings; false to create the chart with no series and only minimal settings, which makes creation faster.

Returns: IChart - The newly created IChart.

addSmartArt(float x, float y, float width, float height, int layoutType)

public abstract ISmartArt addSmartArt(float x, float y, float width, float height, int layoutType)

Creates a SmartArt diagram and adds it to the end of the shape collection.

Example:
 
 Presentation pres = new Presentation();
 try {
      ISlide slide = pres.getSlides().get_Item(0);
      ISmartArt smart = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.BasicBlockList);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the diagram’s frame, in points.
y	float	The y-coordinate of the diagram’s frame, in points.
width	float	The width of the diagram’s frame, in points.
height	float	The height of the diagram’s frame, in points.
layoutType	int	The SmartArt layout type.

Returns: ISmartArt - The newly created ISmartArt.

insertChart(int type, float x, float y, float width, float height, int index)

public abstract IChart insertChart(int type, float x, float y, float width, float height, int index)

Creates a new chart, initializes it with sample series data and settings, and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
type	int	The type of chart to create.
x	float	The x-coordinate of the new chart, in points.
y	float	The y-coordinate of the new chart, in points.
width	float	The width of the new chart, in points.
height	float	The height of the new chart, in points.
index	int	The zero-based index at which to insert the new chart in the shape collection.

Returns: IChart - The newly created IChart.

insertChart(int type, float x, float y, float width, float height, int index, boolean initWithSample)

public abstract IChart insertChart(int type, float x, float y, float width, float height, int index, boolean initWithSample)

Creates a new chart, initializes it with sample series data and settings, and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
type	int	The type of chart to create.
x	float	The x-coordinate of the new chart, in points.
y	float	The y-coordinate of the new chart, in points.
width	float	The width of the new chart, in points.
height	float	The height of the new chart, in points.
index	int	The zero-based index at which to insert the new chart in the shape collection.
initWithSample	boolean	True to initialize the new chart with sample series data and settings; false to create the chart with no series and only minimal settings, which makes creation faster.

Returns: IChart - The newly created IChart.

addOleObjectFrame(float x, float y, float width, float height, IOleEmbeddedDataInfo dataInfo)

public abstract IOleObjectFrame addOleObjectFrame(float x, float y, float width, float height, IOleEmbeddedDataInfo dataInfo)

Creates a new OLE object frame and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new OLE frame, in points.
y	float	The y-coordinate of the new OLE frame, in points.
width	float	The width of the new OLE frame, in points.
height	float	The height of the new OLE frame, in points.
dataInfo	IOleEmbeddedDataInfo	The embedded OLE data information (IOleEmbeddedDataInfo).

Returns: IOleObjectFrame - The newly created IOleObjectFrame.

addOleObjectFrame(float x, float y, float width, float height, String className, String path)

public abstract IOleObjectFrame addOleObjectFrame(float x, float y, float width, float height, String className, String path)

Creates a new OLE object frame and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new OLE frame, in points.
y	float	The y-coordinate of the new OLE frame, in points.
width	float	The width of the new OLE frame, in points.
height	float	The height of the new OLE frame, in points.
className	java.lang.String	The class name of the OLE object.
path	java.lang.String	The path to the linked file.

This path is stored verbatim in the presentation. If a relative path is specified, the file will be inaccessible when opening the presentation from a different directory. |

Returns: IOleObjectFrame - The newly created IOleObjectFrame.

insertOleObjectFrame(int index, float x, float y, float width, float height, IOleEmbeddedDataInfo dataInfo)

public abstract IOleObjectFrame insertOleObjectFrame(int index, float x, float y, float width, float height, IOleEmbeddedDataInfo dataInfo)

Creates a new OLE object frame and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the OLE object frame.
x	float	The x-coordinate of the new OLE frame, in points.
y	float	The y-coordinate of the new OLE frame, in points.
width	float	The width of the new OLE frame, in points.
height	float	The height of the new OLE frame, in points.
dataInfo	IOleEmbeddedDataInfo	The embedded OLE data information (IOleEmbeddedDataInfo).

Returns: IOleObjectFrame - The newly created IOleObjectFrame.

insertOleObjectFrame(int index, float x, float y, float width, float height, String className, String path)

public abstract IOleObjectFrame insertOleObjectFrame(int index, float x, float y, float width, float height, String className, String path)

Creates a new OLE object frame and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the OLE object frame.
x	float	The x-coordinate of the new OLE frame, in points.
y	float	The y-coordinate of the new OLE frame, in points.
width	float	The width of the new OLE frame, in points.
height	float	The height of the new OLE frame, in points.
className	java.lang.String	The class name of the OLE object.
path	java.lang.String	The path to the linked file.

This path is stored verbatim in the presentation. If a relative path is specified, the file will be inaccessible when opening the presentation from a different directory. |

Returns: IOleObjectFrame - The newly created IOleObjectFrame.

addZoomFrame(float x, float y, float width, float height, ISlide slide)

public abstract IZoomFrame addZoomFrame(float x, float y, float width, float height, ISlide slide)

Creates a new Zoom frame and adds it to the end of the shape collection.

This example demonstrates adding a Zoom object to the end of a collection
 (assume that there are at least two slides in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     IZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().addZoomFrame(150, 20, 50, 50, pres.getSlides().get_Item(1));
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new Zoom frame, in points.
y	float	The y-coordinate of the new Zoom frame, in points.
width	float	The width of the new Zoom frame, in points.
height	float	The height of the new Zoom frame, in points.
slide	ISlide	The ISlide referenced by the Zoom frame; must belong to this presentation.

Returns: IZoomFrame - The newly created IZoomFrame.

addZoomFrame(float x, float y, float width, float height, ISlide slide, IPPImage image)

public abstract IZoomFrame addZoomFrame(float x, float y, float width, float height, ISlide slide, IPPImage image)

Creates a new Zoom frame and adds it to the end of the shape collection.

This example demonstrates adding a Zoom object to the end of a collection
 (assume that there are at least two slides in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     IPPImage image = pres.getImages().addImage(imageBytes);
     IZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().addZoomFrame(150, 20, 50, 50, pres.getSlides().get_Item(1), image);
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new Zoom frame, in points.
y	float	The y-coordinate of the new Zoom frame, in points.
width	float	The width of the new Zoom frame, in points.
height	float	The height of the new Zoom frame, in points.
slide	ISlide	The ISlide referenced by the Zoom frame; must belong to this presentation.
image	IPPImage	The image for the referenced slide IPPImage.

Returns: IZoomFrame - The newly created IZoomFrame.

insertZoomFrame(int index, float x, float y, float width, float height, ISlide slide)

public abstract IZoomFrame insertZoomFrame(int index, float x, float y, float width, float height, ISlide slide)

Creates a new Zoom frame and inserts it into the shape collection at the specified index.

This example demonstrates creation and inserting a Zoom object at the specified index of a collection
 (assume that there are at least two slides in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     IZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().insertZoomFrame(2, 150, 20, 50, 50, pres.getSlides().get_Item(1));
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the Zoom frame.
x	float	The x-coordinate of the new Zoom frame, in points.
y	float	The y-coordinate of the new Zoom frame, in points.
width	float	The width of the new Zoom frame, in points.
height	float	The height of the new Zoom frame, in points.
slide	ISlide	The ISlide referenced by the Zoom frame.

Returns: IZoomFrame - The newly created IZoomFrame.

insertZoomFrame(int index, float x, float y, float width, float height, ISlide slide, IPPImage image)

public abstract IZoomFrame insertZoomFrame(int index, float x, float y, float width, float height, ISlide slide, IPPImage image)

Creates a new Zoom frame with a predefined image and inserts it into the shape collection at the specified index.

This example demonstrates creation and inserting a Zoom object at the specified index of a collection
 (assume that there are at least two slides in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     IPPImage image = pres.getImages().addImage(imageBytes);
     IZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().insertZoomFrame(2, 150, 20, 50, 50, pres.getSlides().get_Item(1), image);
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the Zoom frame.
x	float	The x-coordinate of the new Zoom frame, in points.
y	float	The y-coordinate of the new Zoom frame, in points.
width	float	The width of the new Zoom frame, in points.
height	float	The height of the new Zoom frame, in points.
slide	ISlide	The ISlide referenced by the Zoom frame.
image	IPPImage	The image for the referenced slide IPPImage.

Returns: IZoomFrame - The newly created IZoomFrame.

addSectionZoomFrame(float x, float y, float width, float height, ISection section)

public abstract ISectionZoomFrame addSectionZoomFrame(float x, float y, float width, float height, ISection section)

Creates a new Section Zoom frame and adds it to the end of the shape collection.

This example demonstrates adding a Section Zoom object to the end of a collection
 (assume that there are at least two sections in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     ISectionZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().addSectionZoomFrame(150, 20, 50, 50, pres.getSections().get_Item(1));
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new Section Zoom frame, in points.
y	float	The y-coordinate of the new Section Zoom frame, in points.
width	float	The width of the new Section Zoom frame, in points.
height	float	The height of the new Section Zoom frame, in points.
section	ISection	The ISection referenced by the Section Zoom frame; must belong to this presentation and contain at least one slide.

Returns: ISectionZoomFrame - The newly created ISectionZoomFrame.

addSectionZoomFrame(float x, float y, float width, float height, ISection section, IPPImage image)

public abstract ISectionZoomFrame addSectionZoomFrame(float x, float y, float width, float height, ISection section, IPPImage image)

Creates a new Section Zoom frame with a predefined image and adds it to the end of the shape collection.

This example demonstrates adding a Section Zoom object to the end of a collection
 (assume that there are at least two sections in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     IPPImage image = pres.getImages().addImage(Files.readAllBytes(Paths.get("image.png")));
     ISectionZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().addSectionZoomFrame(150, 20, 50, 50, pres.getSections().get_Item(1), image);
 } catch (IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new Section Zoom frame, in points.
y	float	The y-coordinate of the new Section Zoom frame, in points.
width	float	The width of the new Section Zoom frame, in points.
height	float	The height of the new Section Zoom frame, in points.
section	ISection	The ISection referenced by the Section Zoom frame; must belong to this presentation and contain at least one slide.
image	IPPImage	The IPPImage to display within the Section Zoom frame.

Returns: ISectionZoomFrame - The newly created ISectionZoomFrame.

insertSectionZoomFrame(int index, float x, float y, float width, float height, ISection section)

public abstract ISectionZoomFrame insertSectionZoomFrame(int index, float x, float y, float width, float height, ISection section)

Creates a new Section Zoom frame and inserts it into to the shape collection at the specified index.

This example demonstrates the creation and inserting a Section Zoom object at the specified index of a collection
 (assume that there are at least two sections in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     ISectionZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().insertSectionZoomFrame(2, 150, 20, 50, 50, pres.getSections().get_Item(1));
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the Section Zoom frame.
x	float	The x-coordinate of the new Section Zoom frame, in points.
y	float	The y-coordinate of the new Section Zoom frame, in points.
width	float	The width of the new Section Zoom frame, in points.
height	float	The height of the new Section Zoom frame, in points.
section	ISection	The ISection referenced by the Section Zoom frame; must belong to this presentation and contain at least one slide.

Returns: ISectionZoomFrame - The newly created ISectionZoomFrame.

insertSectionZoomFrame(int index, float x, float y, float width, float height, ISection section, IPPImage image)

public abstract ISectionZoomFrame insertSectionZoomFrame(int index, float x, float y, float width, float height, ISection section, IPPImage image)

Creates a new Section Zoom frame with a predefined image and inserts it into to the shape collection at the specified index.

This example demonstrates the creation and inserting a Section Zoom object at the specified index of a collection
 (assume that there are at least two sections in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     IPPImage image = pres.getImages().addImage(Files.readAllBytes(Paths.get("image.png")));
     ISectionZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().insertSectionZoomFrame(2, 150, 20, 50, 50, pres.getSections().get_Item(1), image);
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the Section Zoom frame.
x	float	The x-coordinate of the new Section Zoom frame, in points.
y	float	The y-coordinate of the new Section Zoom frame, in points.
width	float	The width of the new Section Zoom frame, in points.
height	float	The height of the new Section Zoom frame, in points.
section	ISection	The ISection referenced by the Section Zoom frame; must belong to this presentation and contain at least one slide.
image	IPPImage	The image to display within the Section Zoom frame.

Returns: ISectionZoomFrame - The newly created ISectionZoomFrame.

addSummaryZoomFrame(float x, float y, float width, float height)

public abstract ISummaryZoomFrame addSummaryZoomFrame(float x, float y, float width, float height)

Creates a new Summary Zoom frame and adds it to the end of the shape collection.

This example demonstrates adding a Summary Zoom object to the end of a collection
 (assume that there are at least two sections in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     ISummaryZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().addSummaryZoomFrame(150, 20, 500, 250);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new Summary Zoom frame, in points.
y	float	The y-coordinate of the new Summary Zoom frame, in points.
width	float	The width of the new Summary Zoom frame, in points.
height	float	The height of the new Summary Zoom frame, in points.

This method creates a Summary Zoom frame that aggregates summary links for all sections in the presentation. |

Returns: ISummaryZoomFrame - The newly created ISummaryZoomFrame.

insertSummaryZoomFrame(int index, float x, float y, float width, float height)

public abstract ISummaryZoomFrame insertSummaryZoomFrame(int index, float x, float y, float width, float height)

Creates a new Summary Zoom frame and inserts it into the shape collection at the specified index.

This example demonstrates creation and inserting a Summary Zoom object at the specified index of a collection
 (assume that there are at least two sections in the "Presentation.pptx" presentation):
 
 Presentation pres = new Presentation("Presentation.pptx");
 try {
     ISummaryZoomFrame zoomFrame = pres.getSlides().get_Item(0).getShapes().insertSummaryZoomFrame(2, 150, 20, 50, 50);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the Summary Zoom frame.
x	float	The x-coordinate of the new Summary Zoom frame, in points.
y	float	The y-coordinate of the new Summary Zoom frame, in points.
width	float	The width of the new Summary Zoom frame, in points.
height	float	The height of the new Summary Zoom frame, in points.

This method creates a Summary Zoom frame that aggregates summary links for all sections in the presentation. |

Returns: ISummaryZoomFrame - The newly created ISummaryZoomFrame.

addVideoFrame(float x, float y, float width, float height, String fname)

public abstract IVideoFrame addVideoFrame(float x, float y, float width, float height, String fname)

Creates a new video frame and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new video frame, in points.
y	float	The y-coordinate of the new video frame, in points.
width	float	The width of the new video frame, in points.
height	float	The height of the new video frame, in points.
fname	java.lang.String	The path or name of the video file to embed.

Returns: IVideoFrame - The newly created IVideoFrame.

addVideoFrame(float x, float y, float width, float height, IVideo video)

public abstract IVideoFrame addVideoFrame(float x, float y, float width, float height, IVideo video)

Creates a new video frame and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new video frame, in points.
y	float	The y-coordinate of the new video frame, in points.
width	float	The width of the new video frame, in points.
height	float	The height of the new video frame, in points.
video	IVideo	The IVideo to embed in the video frame.

Returns: IVideoFrame - The newly created IVideoFrame.

insertVideoFrame(int index, float x, float y, float width, float height, String fname)

public abstract IVideoFrame insertVideoFrame(int index, float x, float y, float width, float height, String fname)

Creates a new video frame and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the video frame.
x	float	The x-coordinate of the new video frame, in points.
y	float	The y-coordinate of the new video frame, in points.
width	float	The width of the new video frame, in points.
height	float	The height of the new video frame, in points.
fname	java.lang.String	The path or name of the video file to embed.

Returns: IVideoFrame - The newly created IVideoFrame.

addAudioFrameCD(float x, float y, float width, float height)

public abstract IAudioFrame addAudioFrameCD(float x, float y, float width, float height)

Creates a new audio frame linked to a CD track and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new audio frame, in points.
y	float	The y-coordinate of the new audio frame, in points.
width	float	The width of the new audio frame, in points.
height	float	The height of the new audio frame, in points.

Returns: IAudioFrame - The newly created IAudioFrame.

insertAudioFrameCD(int index, float x, float y, float width, float height)

public abstract IAudioFrame insertAudioFrameCD(int index, float x, float y, float width, float height)

Creates a new audio frame linked to a CD track and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the audio frame.
x	float	The x-coordinate of the new audio frame, in points.
y	float	The y-coordinate of the new audio frame, in points.
width	float	The width of the new audio frame, in points.
height	float	The height of the new audio frame, in points.

Returns: IAudioFrame - The newly created IAudioFrame.

addAudioFrameLinked(float x, float y, float width, float height, String fname)

public abstract IAudioFrame addAudioFrameLinked(float x, float y, float width, float height, String fname)

Creates a new audio frame linked to an external audio file and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new audio frame, in points.
y	float	The y-coordinate of the new audio frame, in points.
width	float	The width of the new audio frame, in points.
height	float	The height of the new audio frame, in points.
fname	java.lang.String	The path or name of the external audio file to link.

Returns: IAudioFrame - The newly created IAudioFrame.

insertAudioFrameLinked(int index, float x, float y, float width, float height, String fname)

public abstract IAudioFrame insertAudioFrameLinked(int index, float x, float y, float width, float height, String fname)

Creates a new audio frame linked to an external audio file and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the audio frame.
x	float	The x-coordinate of the new audio frame, in points.
y	float	The y-coordinate of the new audio frame, in points.
width	float	The width of the new audio frame, in points.
height	float	The height of the new audio frame, in points.
fname	java.lang.String	The path or name of the external audio file to link.

Returns: IAudioFrame - The newly created IAudioFrame.

addAudioFrameEmbedded(float x, float y, float width, float height, InputStream audio_stream)

public abstract IAudioFrame addAudioFrameEmbedded(float x, float y, float width, float height, InputStream audio_stream)

Creates a new audio frame with an embedded WAV file and adds it to the end of the shape collection. The embedded audio is added to the Presentation.Audios collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new audio frame, in points.
y	float	The y-coordinate of the new audio frame, in points.
width	float	The width of the new audio frame, in points.
height	float	The height of the new audio frame, in points.
audio_stream	java.io.InputStream	An input stream containing WAV audio data to embed.

Returns: IAudioFrame - The newly created IAudioFrame.

addAudioFrameEmbedded(float x, float y, float width, float height, IAudio audio)

public abstract IAudioFrame addAudioFrameEmbedded(float x, float y, float width, float height, IAudio audio)

Creates a new audio frame and adds it to the end of the shape collection using an existing audio object from the Presentation.Audios list.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the new audio frame, in points.
y	float	The y-coordinate of the new audio frame, in points.
width	float	The width of the new audio frame, in points.
height	float	The height of the new audio frame, in points.
audio	IAudio	An IAudio instance from the Presentation.Audios collection.

Returns: IAudioFrame - The newly created IAudioFrame.

insertAudioFrameEmbedded(int index, float x, float y, float width, float height, InputStream audio_stream)

public abstract IAudioFrame insertAudioFrameEmbedded(int index, float x, float y, float width, float height, InputStream audio_stream)

Creates a new audio frame with an embedded WAV file and inserts it into the shape collection at the specified index. The embedded audio is added to the Presentation.Audios collection.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the audio frame.
x	float	The x-coordinate of the new audio frame, in points.
y	float	The y-coordinate of the new audio frame, in points.
width	float	The width of the new audio frame, in points.
height	float	The height of the new audio frame, in points.
audio_stream	java.io.InputStream	An input stream containing WAV audio data to embed.

Returns: IAudioFrame - The newly created IAudioFrame.

insertAudioFrameEmbedded(int index, float x, float y, float width, float height, IAudio audio)

public abstract IAudioFrame insertAudioFrameEmbedded(int index, float x, float y, float width, float height, IAudio audio)

Creates a new audio frame and inserts it into the shape collection at the specified index using an existing audio object from the Presentation.Audios list.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the audio frame.
x	float	The x-coordinate of the new audio frame, in points.
y	float	The y-coordinate of the new audio frame, in points.
width	float	The width of the new audio frame, in points.
height	float	The height of the new audio frame, in points.
audio	IAudio	An IAudio instance from the Presentation.Audios collection to embed.

Returns: IAudioFrame - The newly created IAudioFrame.

indexOf(IShape shape)

public abstract int indexOf(IShape shape)

Returns the zero-based index of the first occurrence of the specified shape in the collection.

Parameters:

Parameter	Type	Description
shape	IShape	The shape to locate in the collection.

Returns: int - The zero-based index of the first occurrence of the shape in the shape collection if found; otherwise, \u20131.

toArray()

public abstract IShape[] toArray()

Creates and returns an array that contains all shapes.

Returns: com.aspose.slides.IShape[] - An array of IShape objects.

toArray(int startIndex, int count)

public abstract IShape[] toArray(int startIndex, int count)

Creates and returns an array that contains all shapes in the specified range.

Parameters:

Parameter	Type	Description
startIndex	int	The index of the first shape to return.
count	int	The number of shapes to return.

Returns: com.aspose.slides.IShape[] - An array of IShape objects.

reorder(int index, IShape shape)

public abstract void reorder(int index, IShape shape)

Moves the specified shape to a new position within the shape collection.

Parameters:

Parameter	Type	Description
index	int	The zero-based target index where the shape will be placed.
shape	IShape	The IShape to move within the collection.

reorder(int index, IShape[] shapes)

public abstract void reorder(int index, IShape[] shapes)

Moves the specified shapes within the shape collection, placing them starting at the given index.

Parameters:

Parameter	Type	Description
index	int	The zero-based target index where the first specified shape will be placed; subsequent shapes follow in the order provided.
shapes	IShape[]	One or more IShape instances to move within the collection.

addAutoShape(int shapeType, float x, float y, float width, float height)

public abstract IAutoShape addAutoShape(int shapeType, float x, float y, float width, float height)

Creates a new auto shape with default formatting and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
shapeType	int	The ShapeType of the auto shape to add.
x	float	The x-coordinate of the shape’s frame, in points.
y	float	The y-coordinate of the shape’s frame, in points.
width	float	The width of the shape’s frame, in points.
height	float	The height of the shape’s frame, in points.

Returns: IAutoShape - The newly created IAutoShape.

addAutoShape(int shapeType, float x, float y, float width, float height, boolean createFromTemplate)

public abstract IAutoShape addAutoShape(int shapeType, float x, float y, float width, float height, boolean createFromTemplate)

Creates a new auto shape and adds it to the end of the shape collection, optionally initializing it with default template formatting.

Parameters:

Parameter	Type	Description
shapeType	int	The ShapeType of the auto shape to add.
x	float	The x-coordinate of the shape’s frame, in points.
y	float	The y-coordinate of the shape’s frame, in points.
width	float	The width of the shape’s frame, in points.
height	float	The height of the shape’s frame, in points.
createFromTemplate	boolean	True to apply default template styling (simple style, centered text, and non-empty name) to the new shape; false to create the shape with all properties set to their default values.

Returns: IAutoShape - The newly created IAutoShape.

addMathShape(float x, float y, float width, float height)

public abstract IAutoShape addMathShape(float x, float y, float width, float height)

Creates a new rectangle auto shape to host mathematical content and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the shape’s frame, in points.
y	float	The y-coordinate of the shape’s frame, in points.
width	float	The width of the shape’s frame, in points.
height	float	The height of the shape’s frame, in points.

Returns: IAutoShape - The newly created IAutoShape.

insertAutoShape(int index, int shapeType, float x, float y, float width, float height)

public abstract IAutoShape insertAutoShape(int index, int shapeType, float x, float y, float width, float height)

Creates a new auto shape and inserts it into the shape collection at the specified index, applying default template formatting.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the new auto shape.
shapeType	int	The ShapeType of the auto shape to insert.
x	float	The x-coordinate of the shape’s frame, in points.
y	float	The y-coordinate of the shape’s frame, in points.
width	float	The width of the shape’s frame, in points.
height	float	The height of the shape’s frame, in points.

Returns: IAutoShape - The newly created IAutoShape.

insertAutoShape(int index, int shapeType, float x, float y, float width, float height, boolean createFromTemplate)

public abstract IAutoShape insertAutoShape(int index, int shapeType, float x, float y, float width, float height, boolean createFromTemplate)

Creates a new auto shape and inserts it into the shape collection at the specified index, optionally initializing it with default template styling.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the auto shape.
shapeType	int	The ShapeType of the auto shape to insert.
x	float	The x-coordinate of the shape’s frame, in points.
y	float	The y-coordinate of the shape’s frame, in points.
width	float	The width of the shape’s frame, in points.
height	float	The height of the shape’s frame, in points.
createFromTemplate	boolean	True to apply default template styling (including a non-empty name, simple style, and centered text); false to create the shape with all properties set to their defaults.

Returns: IAutoShape - The newly created IAutoShape.

addGroupShape()

public abstract IGroupShape addGroupShape()

Creates a new empty group shape and adds it to the end of the shape collection. The group’s frame will automatically adjust to fit any shapes added to it.

Returns: IGroupShape - The newly created IGroupShape.

addGroupShape(ISvgImage svgImage, float x, float y, float width, float height)

public abstract IGroupShape addGroupShape(ISvgImage svgImage, float x, float y, float width, float height)

Creates a new group shape, converts the specified SVG image into individual shapes, and adds the resulting group to the end of the shape collection.

Parameters:

Parameter	Type	Description
svgImage	ISvgImage	The ISvgImage containing vector content to convert into shapes.
x	float	The x-coordinate of the group’s frame, in points.
y	float	The y-coordinate of the group’s frame, in points.
width	float	The width of the group’s frame, in points.
height	float	The height of the group’s frame, in points.

Returns: IGroupShape - The newly created IGroupShape.

insertGroupShape(int index)

public abstract IGroupShape insertGroupShape(int index)

Creates a new empty group shape and inserts it to the shape collection at the specified index. The group’s frame will automatically adjust to fit any shapes added to it.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the group shape.

Returns: IGroupShape - The newly created IGroupShape.

addConnector(int shapeType, float x, float y, float width, float height)

public abstract IConnector addConnector(int shapeType, float x, float y, float width, float height)

Creates a new connector shape with default template styling and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
shapeType	int	The ShapeType of the connector shape to add.
x	float	The x-coordinate of the connector’s frame, in points.
y	float	The y-coordinate of the connector’s frame, in points.
width	float	The width of the connector’s frame, in points.
height	float	The height of the connector’s frame, in points.

Returns: IConnector - The newly created IConnector.

addConnector(int shapeType, float x, float y, float width, float height, boolean createFromTemplate)

public abstract IConnector addConnector(int shapeType, float x, float y, float width, float height, boolean createFromTemplate)

Creates a new connector shape and adds it to the end of the shape collection, optionally applying default template styling.

Parameters:

Parameter	Type	Description
shapeType	int	The ShapeType of the connector shape to create.
x	float	The x-coordinate of the connector’s frame, in points.
y	float	The y-coordinate of the connector’s frame, in points.
width	float	The width of the connector’s frame, in points.
height	float	The height of the connector’s frame, in points.
createFromTemplate	boolean	True to apply default template styling (non-empty name, simple style); false to create the connector with default property values.

Returns: IConnector - The newly created IConnector.

insertConnector(int index, int shapeType, float x, float y, float width, float height)

public abstract IConnector insertConnector(int index, int shapeType, float x, float y, float width, float height)

Creates a new connector shape and inserts it into the shape collection at the specified index, applying default template styling.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the connector shape.
shapeType	int	The ShapeType of the connector shape to insert.
x	float	The x-coordinate of the connector’s frame, in points.
y	float	The y-coordinate of the connector’s frame, in points.
width	float	The width of the connector’s frame, in points.
height	float	The height of the connector’s frame, in points.

Returns: IConnector - The newly created IConnector.

insertConnector(int index, int shapeType, float x, float y, float width, float height, boolean createFromTemplate)

public abstract IConnector insertConnector(int index, int shapeType, float x, float y, float width, float height, boolean createFromTemplate)

Creates a new connector shape and inserts it into the shape collection at the specified index, optionally applying default template styling.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the connector shape.
shapeType	int	The ShapeType of the connector shape to insert.
x	float	The x-coordinate of the connector’s frame, in points.
y	float	The y-coordinate of the connector’s frame, in points.
width	float	The width of the connector’s frame, in points.
height	float	The height of the connector’s frame, in points.
createFromTemplate	boolean	True to apply default template styling (non-empty name, simple style); false to create the connector with default property values.

Returns: IConnector - The newly created IConnector.

addPictureFrame(int shapeType, float x, float y, float width, float height, IPPImage image)

public abstract IPictureFrame addPictureFrame(int shapeType, float x, float y, float width, float height, IPPImage image)

Creates a new picture frame containing the specified image and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
shapeType	int	Specifies the shape type contained in ShapeType, except for all kinds of lines:

ShapeType.Line,

ShapeType.StraightConnector1,

ShapeType.BentConnector2,

ShapeType.BentConnector3,

ShapeType.BentConnector4,

ShapeType.BentConnector5,

ShapeType.CurvedConnector2,

ShapeType.CurvedConnector3,

ShapeType.CurvedConnector4,

Returns: IPictureFrame - The newly created IPictureFrame.

insertPictureFrame(int index, int shapeType, float x, float y, float width, float height, IPPImage image)

public abstract IPictureFrame insertPictureFrame(int index, int shapeType, float x, float y, float width, float height, IPPImage image)

Creates a new picture frame containing the specified image and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the picture frame.
shapeType	int	Specifies the shape type contained in ShapeType, except for all kinds of lines:

ShapeType.Line,

ShapeType.StraightConnector1,

ShapeType.BentConnector2,

ShapeType.BentConnector3,

ShapeType.BentConnector4,

ShapeType.BentConnector5,

ShapeType.CurvedConnector2,

ShapeType.CurvedConnector3,

ShapeType.CurvedConnector4,

Returns: IPictureFrame - The newly created IPictureFrame.

addTable(float x, float y, double[] columnWidths, double[] rowHeights)

public abstract ITable addTable(float x, float y, double[] columnWidths, double[] rowHeights)

Creates a new table and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
x	float	The x-coordinate of the table, in points.
y	float	The y-coordinate of the table, in points.
columnWidths	double[]	An array of doubles representing the widths of the table’s columns, in points.
rowHeights	double[]	An array of doubles representing the heights of the table’s rows, in points.

Returns: ITable - The newly created ITable.

insertTable(int index, float x, float y, double[] columnWidths, double[] rowHeights)

public abstract ITable insertTable(int index, float x, float y, double[] columnWidths, double[] rowHeights)

Creates a new table and inserts it into the shape collection at the specified index.

Parameters:

Parameter	Type	Description
index	int	The zero-based index at which to insert the table.
x	float	The x-coordinate of the table, in points.
y	float	The y-coordinate of the table, in points.
columnWidths	double[]	An array of doubles representing the widths of the table’s columns, in points.
rowHeights	double[]	An array of doubles representing the heights of the table’s rows, in points.

Returns: ITable - The newly created ITable.

removeAt(int index)

public abstract void removeAt(int index)

Removes the shape at the specified index from the shape collection.

Parameters:

Parameter	Type	Description
index	int	The zero-based index of the shape to remove.

remove(IShape shape)

public abstract void remove(IShape shape)

Removes the first occurrence of the specified shape from the shape collection.

Parameters:

Parameter	Type	Description
shape	IShape	The IShape to remove.

clear()

public abstract void clear()

Removes all shapes from the shape collection.

addClone(IShape sourceShape, float x, float y, float width, float height)

public abstract IShape addClone(IShape sourceShape, float x, float y, float width, float height)

Creates a copy of the specified shape and adds it to the end of the shape collection.

Parameters:

Parameter	Type	Description
sourceShape	IShape	The shape to clone.
x	float	The x-coordinate of the cloned shape’s frame, in points.
y	float	The y-coordinate of the cloned shape’s frame, in points.
width	float	The width of the cloned shape’s frame, in points.
height	float	The height of the cloned shape’s frame, in points.