ShapeCollection

Inheritance: java.lang.Object, com.aspose.slides.DomObject

All Implemented Interfaces: com.aspose.slides.IShapeCollection

public final class ShapeCollection extends DomObject<GroupShape> implements IShapeCollection

Represents a collection of shapes.

Methods

size()

public final int size()

Gets the number of elements actually contained in the collection. Read-only int .

Returns: int

get_Item(int index)

public final IShape get_Item(int index)

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

Parameters:

Returns: IShape

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

public final 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.

The following example shows how to create Chart in PowerPoint Presentation.
 
 // Instantiates the Presentation class that represents a PPTX file
 Presentation pres = new Presentation();
 try {
     // Accesses the first slide
     ISlide sld = pres.getSlides().get_Item(0);
     // Adds a chart with its default data
     IChart chart = sld.getShapes().addChart(ChartType.ClusteredColumn, 0, 0, 500, 500);
     // Sets the chart title
     chart.getChartTitle().addTextFrameForOverriding("Sample Title");
     chart.getChartTitle().getTextFrameForOverriding().getTextFrameFormat().setCenterText(NullableBool.True);
     chart.getChartTitle().setHeight(20);
     chart.setTitle(true);
     // Sets the first series to show values
     chart.getChartData().getSeries().get_Item(0).getLabels().getDefaultDataLabelFormat().setShowValue(true);
     // Sets the index for the chart data sheet
     int defaultWorksheetIndex = 0;
     // Gets the chart data worksheet
     IChartDataWorkbook fact = chart.getChartData().getChartDataWorkbook();
     // Deletes the default generated series and categories
     chart.getChartData().getSeries().clear();
     chart.getChartData().getCategories().clear();
     // Adds new series
     chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.getType());
     chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.getType());
     // Adds new categories
     chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 1, 0, "Caetegoty 1"));
     chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 2, 0, "Caetegoty 2"));
     chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 3, 0, "Caetegoty 3"));
     // Takes the first chart series
     IChartSeries series = chart.getChartData().getSeries().get_Item(0);
     // Populates series data
     series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 1, 20));
     series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 1, 50));
     series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 1, 30));
     // Sets the fill color for the series
     series.getFormat().getFill().setFillType(FillType.Solid);
     series.getFormat().getFill().getSolidFillColor().setColor(Color.RED);
     // Takes the second chart series
     series = chart.getChartData().getSeries().get_Item(1);
     // Populates series data
     series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 2, 30));
     series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 2, 10));
     series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 2, 60));
     // Sets the fill color for series
     series.getFormat().getFill().setFillType(FillType.Solid);
     series.getFormat().getFill().getSolidFillColor().setColor(Color.GREEN);
     // Sets the first label to show Category name
     IDataLabel lbl = series.getDataPoints().get_Item(0).getLabel();
     lbl.getDataLabelFormat().setShowCategoryName(true);
     lbl = series.getDataPoints().get_Item(1).getLabel();
     lbl.getDataLabelFormat().setShowSeriesName(true);
     // Sets the series to show the value for the third label
     lbl = series.getDataPoints().get_Item(2).getLabel();
     lbl.getDataLabelFormat().setShowValue(true);
     lbl.getDataLabelFormat().setShowSeriesName(true);
     lbl.getDataLabelFormat().setSeparator("/");
     // Saves the PPTX file to disk
     pres.save("AsposeChart_out.pptx", SaveFormat.Pptx);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Returns: IChart - The newly created IChart.

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

public final 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:

Returns: IChart - The newly created IChart.

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

public final 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.

The following example shows how to add smart shape in PowerPoint Presentation.
 
 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:

Returns: ISmartArt - The newly created ISmartArt.

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

public final 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:

Returns: IChart - The newly created IChart.

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

public final 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:

Returns: IChart - The newly created IChart.

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

public final 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:

Returns: IZoomFrame - The newly created IZoomFrame.

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

public final 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);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Returns: IZoomFrame - The newly created IZoomFrame.

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

public final 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:

Returns: IZoomFrame - The newly created IZoomFrame.

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

public final 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);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Returns: IZoomFrame - The newly created IZoomFrame.

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

public final 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:

Returns: ISectionZoomFrame - The newly created ISectionZoomFrame.

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

public final 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:

Returns: ISectionZoomFrame - The newly created ISectionZoomFrame.

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

public final 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:

Returns: ISectionZoomFrame - The newly created ISectionZoomFrame.

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

public final 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:

Returns: ISectionZoomFrame - The newly created ISectionZoomFrame.

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

public final 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:

This method creates a new Summary Zoom and puts a collection of objects into it for all the sections in this presentation. |

Returns: ISummaryZoomFrame - The newly created ISummaryZoomFrame.

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

public final 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:

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

Returns: ISummaryZoomFrame - The newly created ISummaryZoomFrame.

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

public final 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.

The following examples shows how to adding OLE Object Frames to Slides of PowerPoint Presentation.
 
 // Instantiate Presentation class that represents the PPTX
 Presentation pres = new Presentation();
 try
 {
     // Access the first slide
     ISlide sld = pres.getSlides().get_Item(0);

     // Load an cel file to stream
     FileInputStream fs = new FileInputStream("book1.xlsx");
     ByteArrayOutputStream mstream = new ByteArrayOutputStream();
     byte[] buf = new byte[4096];

     while (true)
     {
         int bytesRead = fs.read(buf, 0, buf.length);
         if (bytesRead <= 0)
             break;
         mstream.write(buf, 0, bytesRead);
     }
     // Create data object for embedding
     IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(mstream.toByteArray(), "xlsx");

     // Add an Ole Object Frame shape
     IOleObjectFrame oleObjectFrame = sld.getShapes().addOleObjectFrame(0, 0, (float)pres.getSlideSize().getSize().getWidth(),
             (float)pres.getSlideSize().getSize().getHeight(), dataInfo);

     //Write the PPTX to disk
     pres.save("OleEmbed_out.pptx", SaveFormat.Pptx);
 }
 catch (IOException e) { }
 finally
 {
     if (pres != null) pres.dispose();
 }

Parameters:

Returns: IOleObjectFrame - The newly created IOleObjectFrame.

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

public final 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:

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 final 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.

This example demonstrates inserting an OLE object at the second index:
 
 byte[] fileData = Files.readAllBytes(Paths.get("test.zip"));
 IOleDataInfo dataInfo = new OleDataInfo(fileData, "zip");
 IOleObjectFrame oleObjectFrame = slides.getShapes().addOleObjectFrame(2, 150, 20, 50, 50, dataInfo);

Parameters:

Returns: IOleObjectFrame - The newly created IOleObjectFrame.

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

public final 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:

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 OLE object frame.

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

public final 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:

Returns: IVideoFrame - The newly created IVideoFrame.

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

public final 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:

Returns: IVideoFrame - The newly created IVideoFrame.

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

public final 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:

Returns: IVideoFrame - The newly created IVideoFrame.

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

public final 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:

Returns: IAudioFrame - The newly created IAudioFrame.

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

public final 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:

Returns: IAudioFrame - The newly created IAudioFrame.

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

public final 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:

Returns: IAudioFrame - The newly created IAudioFrame.

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

public final 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:

Returns: IAudioFrame - The newly created IAudioFrame.

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

public final 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.

The following examples shows how to create Audio Frame.
 
 // Instantiates a presentation class that represents a presentation file
 Presentation pres = new Presentation();
 try {
     // Gets the first slide
     ISlide sld = pres.getSlides().get_Item(0);
     // Loads the the wav sound file to stream
     FileInputStream fstr = new FileInputStream("sampleaudio.wav");
     try {
         // Adds the Audio Frame
         IAudioFrame audioFrame = sld.getShapes().addAudioFrameEmbedded(50, 150, 100, 100, fstr);
         // Sets the Play Mode and Volume of the Audio
         audioFrame.setPlayMode(AudioPlayModePreset.Auto);
         audioFrame.setVolume(AudioVolumeMode.Loud);
     } finally {
         if (fstr != null) fstr.close();
     }
     // Writes the PowerPoint file to disk
     pres.save("AudioFrameEmbed_out.pptx", SaveFormat.Pptx);
 } catch(IOException e) {
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Returns: IAudioFrame - The newly created IAudioFrame.

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

public final 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:

Returns: IAudioFrame - The newly created IAudioFrame.

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

public final 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:

Returns: IAudioFrame - The newly created IAudioFrame.

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

public final 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:

Returns: IAudioFrame - The newly created IAudioFrame.

indexOf(IShape shape)

public final int indexOf(IShape shape)

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

Parameters:

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

toArray()

public final 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 final IShape[] toArray(int startIndex, int count)

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

Parameters:

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

reorder(int index, IShape shape)

public final void reorder(int index, IShape shape)

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

Parameters:

reorder(int index, IShape[] shapes)

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

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

Parameters:

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

public final 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:

Returns: IAutoShape - The newly created IAutoShape.

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

public final 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:

Returns: IAutoShape - The newly created IAutoShape.

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

public final 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.

The following example shows how to add Mathematical Equation in PowerPoint Presentation.
 
 Presentation pres = new Presentation();
 try {
     IAutoShape mathShape = pres.getSlides().get_Item(0).getShapes().addMathShape(0, 0, 720, 150);
     IMathParagraph mathParagraph = ((MathPortion)mathShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)).getMathParagraph();
     IMathFraction fraction = new MathematicalText("x").divide("y");
     mathParagraph.add(new MathBlock(fraction));
     IMathBlock mathBlock = new MathematicalText("c")
         .setSuperscript("2")
         .join("=")
         .join(new MathematicalText("a").setSuperscript("2"))
         .join("+")
         .join(new MathematicalText("b").setSuperscript("2"));
     mathParagraph.add(mathBlock);
     pres.save("math.pptx", SaveFormat.Pptx);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Returns: IAutoShape - The newly created IAutoShape.

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

public final 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:

Returns: IAutoShape - The newly created IAutoShape.

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

public final 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:

Returns: IAutoShape - The newly created IAutoShape.

addGroupShape()

public final 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.

The following example shows how to add a group shape to a slide of PowerPoint Presentation.
 
 // Instantiate Presentation class
 Presentation pres = new Presentation();
 try {
     // Get the first slide
     ISlide sld = pres.getSlides().get_Item(0);
     // Accessing the shape collection of slides
     IShapeCollection slideShapes = sld.getShapes();
     // Adding a group shape to the slide
     IGroupShape groupShape = slideShapes.addGroupShape();
     // Adding shapes inside added group shape
     groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 300, 100, 100, 100);
     groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 500, 100, 100, 100);
     groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 300, 300, 100, 100);
     groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 500, 300, 100, 100);
     // Adding group shape frame
     groupShape.setFrame(new ShapeFrame(100, 300, 500, 40, NullableBool.False, NullableBool.False, 0));
     // Write the PPTX file to disk
     pres.save("GroupShape_out.pptx", SaveFormat.Pptx);
 } finally {
     if (pres != null) pres.dispose();
 }

Returns: IGroupShape - The newly created IGroupShape.

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

public final 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:

Returns: IGroupShape - The newly created IGroupShape.

insertGroupShape(int index)

public final 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:

Returns: IGroupShape - The newly created IGroupShape.

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

public final 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.

The following example shows how to add a connector (a bent connector) between two shapes (an ellipse and rectangle) in PowerPoint Presentation.
 
 // Instantiates a presentation class that represents a PPTX file
 Presentation pres = new Presentation();
 try {
     // Accesses the shapes collection for a specific slide
     IShapeCollection shapes = pres.getSlides().get_Item(0).getShapes();
     // Adds an Ellipse autoshape
     IAutoShape ellipse = shapes.addAutoShape(ShapeType.Ellipse, 0, 100, 100, 100);
     // Adds a Rectangle autoshape
     IAutoShape rectangle = shapes.addAutoShape(ShapeType.Rectangle, 100, 300, 100, 100);
     // Adds a connector shape to the slide shape collection
     IConnector connector = shapes.addConnector(ShapeType.BentConnector2, 0, 0, 10, 10);
     // Connects the shapes using the connector
     connector.setStartShapeConnectedTo(ellipse);
     connector.setEndShapeConnectedTo(rectangle);
     // Calls reroute that sets the automatic shortest path between shapes
     connector.reroute();
     // Saves the presentation
     pres.save("Shapes-connector.pptx", SaveFormat.Pptx);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Returns: IConnector - The newly created IConnector.

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

public final 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:

Returns: IConnector - The newly created IConnector.

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

public final 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:

Returns: IConnector - The newly created IConnector.

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

public final 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:

Returns: IConnector - The newly created IConnector.

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

public final 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:

ShapeType.Line,

ShapeType.StraightConnector1,

ShapeType.BentConnector2,

ShapeType.BentConnector3,

ShapeType.BentConnector4,

ShapeType.BentConnector5,

ShapeType.CurvedConnector2,

ShapeType.CurvedConnector3,

ShapeType.CurvedConnector4,

ShapeType.CurvedConnector5. | | x | float | The x-coordinate of the picture frame, in points. | | y | float | The y-coordinate of the picture frame, in points. | | width | float | The width of the picture frame, in points. | | height | float | The height of the picture frame, in points. | | image | IPPImage | The IPPImage to display in the picture frame. |

Returns: IPictureFrame - The newly created IPictureFrame.

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

public final 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:

ShapeType.Line,

ShapeType.StraightConnector1,

ShapeType.BentConnector2,

ShapeType.BentConnector3,

ShapeType.BentConnector4,

ShapeType.BentConnector5,

ShapeType.CurvedConnector2,

ShapeType.CurvedConnector3,

ShapeType.CurvedConnector4,

ShapeType.CurvedConnector5. | | x | float | The x-coordinate of the picture frame, in points. | | y | float | The y-coordinate of the picture frame, in points. | | width | float | The width of the picture frame, in points. | | height | float | The height of the picture frame, in points. | | image | IPPImage | The IPPImage to display in the picture frame. |

Returns: IPictureFrame - The newly created IPictureFrame.

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

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

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

The following examples shows how to add table in PowerPoint Presentation.
 
 // Instantiate Presentation class that represents PPTX file
 Presentation pres = new Presentation();
 try
 {
     // Access first slide
     ISlide sld = pres.getSlides().get_Item(0);

     // Define columns with widths and rows with heights
     double[] dblCols = {50, 50, 50};
     double[] dblRows = {50, 30, 30, 30, 30};

     // Add table shape to slide
     ITable tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);

     // Set border format for each cell
     for (int row = 0; row < tbl.getRows().size(); row++)
     {
         for (int cell = 0; cell < tbl.getRows().get_Item(row).size(); cell++)
         {
             tbl.get_Item(cell, row).getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.Solid);
             tbl.get_Item(cell, row).getCellFormat().getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
             tbl.get_Item(cell, row).getCellFormat().getBorderTop().setWidth(5);

             tbl.get_Item(cell, row).getCellFormat().getBorderBottom().getFillFormat().setFillType((FillType.Solid));
             tbl.get_Item(cell, row).getCellFormat().getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
             tbl.get_Item(cell, row).getCellFormat().getBorderBottom().setWidth(5);

             tbl.get_Item(cell, row).getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.Solid);
             tbl.get_Item(cell, row).getCellFormat().getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
             tbl.get_Item(cell, row).getCellFormat().getBorderLeft().setWidth(5);

             tbl.get_Item(cell, row).getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.Solid);
             tbl.get_Item(cell, row).getCellFormat().getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
             tbl.get_Item(cell, row).getCellFormat().getBorderRight().setWidth(5);
         }
     }
     // Merge cells 1 & 2 of row 1
     tbl.mergeCells(tbl.get_Item(0, 0), tbl.get_Item(1, 1), false);

     // Add text to the merged cell
     tbl.get_Item(0, 0).getTextFrame().setText("Merged Cells");

     // Save PPTX to Disk
     pres.save("table.pptx", SaveFormat.Pptx);
 }
 finally
 {
     if (pres != null) pres.dispose();
 }

Parameters:

Returns: ITable - The newly created ITable.

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

public final 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:

Returns: ITable - The newly created ITable.

removeAt(int index)

public final void removeAt(int index)

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

Parameters:

remove(IShape shape)

public final void remove(IShape shape)

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

Parameters:

clear()

public final void clear()

Removes all shapes from the shape collection.

iterator()

public final System.Collections.Generic.IGenericEnumerator<IShape> iterator()

Returns an enumerator that iterates through the collection.

Returns: com.aspose.ms.System.Collections.Generic.IGenericEnumerator<com.aspose.slides.IShape> - A IGenericEnumerator that can be used to iterate through the collection.

iteratorJava()

public final System.Collections.Generic.IGenericEnumerator<IShape> iteratorJava()

Returns a java iterator for the entire collection.

Returns: com.aspose.ms.System.Collections.Generic.IGenericEnumerator<com.aspose.slides.IShape> - An java.util.Iterator for the entire collection.

getParentGroup()

public final IGroupShape getParentGroup()

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

Returns: IGroupShape

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

public final 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:

Returns: IShape - The newly created IShape.

addClone(IShape sourceShape, float x, float y)

public final IShape addClone(IShape sourceShape, float x, float y)

Creates a copy of the specified shape and adds it to the end of the shape collection. The new shape retains the width and height of the sourceShape .

Parameters:

Returns: IShape - The newly created IShape.

addClone(IShape sourceShape)

public final IShape addClone(IShape sourceShape)

Creates a copy of the specified shape and adds it to the end of the shape collection. The cloned shape retains the original’s position and size.

Parameters:

Returns: IShape - The newly created IShape.

insertClone(int index, IShape sourceShape, float x, float y, float width, float height)

public final IShape 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.

Parameters:

Returns: IShape - The newly created IShape.

insertClone(int index, IShape sourceShape, float x, float y)

public final IShape 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. The new shape retains the width and height of the sourceShape .

Parameters:

Returns: IShape - The newly created IShape.

insertClone(int index, IShape sourceShape)

public final IShape insertClone(int index, IShape sourceShape)

Creates a copy of the specified shape and inserts it into the shape collection at the specified index. The cloned shape retains the original’s position and size.

Parameters:

Returns: IShape - The newly created IShape.

copyTo(System.Array array, int index)

public final void copyTo(System.Array array, int index)

Copies all elements from the collection to the specified array.

Parameters:

isSynchronized()

public final boolean isSynchronized()

Returns a value indicating whether access to the collection is synchronized (thread-safe). Read-only boolean .

Returns: boolean

getSyncRoot()

public final Object getSyncRoot()

Returns a synchronization root. Read-only Object .

Returns: java.lang.Object