SlideUtil

Inheritance: java.lang.Object

public class SlideUtil

Offer methods which help to search shapes and text in a presentation.

Constructors

Constructor	Description
SlideUtil()

Methods

Method	Description
findShape(IPresentation pres, String altText)	Find shape by alternative text in a PPTX presentation.
findShape(IBaseSlide slide, String altText)	Find shape by alternative text on a slide in a PPTX presentation.
alignShapes(int alignmentType, boolean alignToSlide, IShapeCollection shapes)	Changes the placement of all shapes in the collection.
alignShapes(int alignmentType, boolean alignToSlide, IBaseSlide slide)	Changes the placement of all shapes on the slide.
alignShapes(int alignmentType, boolean alignToSlide, IBaseSlide slide, int[] shapeIndexes)	Changes the placement of selected shapes on the slide.
alignShapes(int alignmentType, boolean alignToSlide, IGroupShape groupShape)	Changes the placement of all shapes within group shape.
alignShapes(int alignmentType, boolean alignToSlide, IGroupShape groupShape, int[] shapeIndexes)	Changes the placement of selected shapes within group shape.
findAndReplaceText(IPresentation presentation, boolean withMasters, String find, String replace)	Finds and replaces text in presentation with given format
findAndReplaceText(IPresentation presentation, boolean withMasters, String find, String replace, PortionFormat format)	Finds and replaces text in presentation with given format
getAllTextBoxes(IBaseSlide slide)	Returns all text frames on a slide in a PPTX presentation.
getAllTextFrames(IPresentation pres, boolean withMasters)	Returns all text frames in a PPTX presentation.

SlideUtil()

public SlideUtil()

findShape(IPresentation pres, String altText)

public static IShape findShape(IPresentation pres, String altText)

Find shape by alternative text in a PPTX presentation.

Parameters:

Parameter	Type	Description
pres	IPresentation	Scanned presentation.
altText	java.lang.String	Alternative text of a shape.

Returns: IShape - Shape or null.

findShape(IBaseSlide slide, String altText)

public static IShape findShape(IBaseSlide slide, String altText)

Find shape by alternative text on a slide in a PPTX presentation.

Parameters:

Parameter	Type	Description
slide	IBaseSlide	Scanned slide.
altText	java.lang.String	Alternative text of a shape.

Returns: IShape - Shape or null.

alignShapes(int alignmentType, boolean alignToSlide, IShapeCollection shapes)

public static void alignShapes(int alignmentType, boolean alignToSlide, IShapeCollection shapes)

Changes the placement of all shapes in the collection. Aligns shapes to the margins or the edge of the slide or align them relative to each other.

---

Example:
 
 Presentation pres = new Presentation("pres.pptx");
 try {
     SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, true, pres.getSlides().get_Item(0).getShapes());
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
alignmentType	int	Determines which type of alignment will be applied.
alignToSlide	boolean	If true, shapes will be aligned relative to the slide edges
shapes	IShapeCollection	Shapes collection to be aligned

alignShapes(int alignmentType, boolean alignToSlide, IBaseSlide slide)

public static void alignShapes(int alignmentType, boolean alignToSlide, IBaseSlide slide)

Changes the placement of all shapes on the slide. Aligns shapes to the margins or the edge of the slide or align them relative to each other.

---

Example:
 
 Presentation pres = new Presentation("pres.pptx");
 try {
     SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, true, pres.getSlides().get_Item(0));
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
alignmentType	int	Determines which type of alignment will be applied.
alignToSlide	boolean	If true, shapes will be aligned relative to the slide edges.
slide	IBaseSlide	Parent slide.

alignShapes(int alignmentType, boolean alignToSlide, IBaseSlide slide, int[] shapeIndexes)

public static void alignShapes(int alignmentType, boolean alignToSlide, IBaseSlide slide, int[] shapeIndexes)

Changes the placement of selected shapes on the slide. Aligns shapes to the margins or the edge of the slide or align them relative to each other.

---

Example:
  
  Presentation pres = new Presentation("pres.pptx");
  try {
     ISlide slide = pres.getSlides().get_Item(0);
     IShape shape1 = slide.getShapes().get_Item(0);
     IShape shape2 = slide.getShapes().get_Item(1);
     SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, false, pres.getSlides().get_Item(0), new int[]
     {
         slide.getShapes().indexOf(shape1),
         slide.getShapes().indexOf(shape2)
     });
  } finally {
     if (pres != null) pres.dispose();
  }

Parameters:

Parameter	Type	Description
alignmentType	int	Determines which type of alignment will be applied.
alignToSlide	boolean	If true, shapes will be aligned relative to the slide edges.
slide	IBaseSlide	Parent slide.
shapeIndexes	int[]	Indexes of shapes to be aligned.

alignShapes(int alignmentType, boolean alignToSlide, IGroupShape groupShape)

public static void alignShapes(int alignmentType, boolean alignToSlide, IGroupShape groupShape)

Changes the placement of all shapes within group shape. Aligns shapes to the margins or the edge of the slide or align them relative to each other.

---

Example:
 
 Presentation pres = new Presentation("pres.pptx");
 try {
     ISlide slide = pres.getSlides().get_Item(0);
     SlideUtil.alignShapes(ShapesAlignmentType.AlignLeft, false, (GroupShape) slide.getShapes().get_Item(0));
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
alignmentType	int	Determines which type of alignment will be applied.
alignToSlide	boolean	If true, shapes will be aligned relative to the slide edges.
groupShape	IGroupShape	Parent group shape.

alignShapes(int alignmentType, boolean alignToSlide, IGroupShape groupShape, int[] shapeIndexes)

public static void alignShapes(int alignmentType, boolean alignToSlide, IGroupShape groupShape, int[] shapeIndexes)

Changes the placement of selected shapes within group shape. Aligns shapes to the margins or the edge of the slide or align them relative to each other.

---

Example:
 
 Presentation pres = new Presentation("pres.pptx");
 try {
     ISlide slide = pres.getSlides().get_Item(0);
     SlideUtil.alignShapes(ShapesAlignmentType.AlignLeft, false, (GroupShape)slide.getShapes().get_Item(0), new int[] { 0, 2 });
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
alignmentType	int	Determines which type of alignment will be applied.
alignToSlide	boolean	If true, shapes will be aligned relative to the slide edges.
groupShape	IGroupShape	Parent group shape.
shapeIndexes	int[]	Indexes of shapes to be aligned.

findAndReplaceText(IPresentation presentation, boolean withMasters, String find, String replace)

public static void findAndReplaceText(IPresentation presentation, boolean withMasters, String find, String replace)

Finds and replaces text in presentation with given format

---

Presentation pres = new Presentation("pres.pptx");
 try {
     PortionFormat format = new PortionFormat();
     format.setFontHeight(24f);
     format.setFontItalic(NullableBool.True);
     format.getFillFormat().setFillType(FillType.Solid);
     format.getFillFormat().getSolidFillColor().setColor(Color.RED);

     SlideUtil.findAndReplaceText(pres, true, "[this block] ", "my text ", format);
     pres.save("replaced.pptx", SaveFormat.Pptx);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
presentation	IPresentation	Scanned presentation.
withMasters	boolean	Determines whether master slides should be scanned.
find	java.lang.String	String value to find.
replace	java.lang.String	String value to replace.

findAndReplaceText(IPresentation presentation, boolean withMasters, String find, String replace, PortionFormat format)

public static void findAndReplaceText(IPresentation presentation, boolean withMasters, String find, String replace, PortionFormat format)

Finds and replaces text in presentation with given format

---

Presentation pres = new Presentation("pres.pptx");
 try {
     PortionFormat format = new PortionFormat();
     format.setFontHeight(24f);
     format.setFontItalic(NullableBool.True);
     format.getFillFormat().setFillType(FillType.Solid);
     format.getFillFormat().getSolidFillColor().setColor(Color.RED);

     SlideUtil.findAndReplaceText(pres, true, "[this block] ", "my text ", format);
     pres.save("replaced.pptx", SaveFormat.Pptx);
 } finally {
     if (pres != null) pres.dispose();
 }

Parameters:

Parameter	Type	Description
presentation	IPresentation	Scanned presentation.
withMasters	boolean	Determines whether master slides should be scanned.
find	java.lang.String	String value to find.
replace	java.lang.String	String value to replace.
format	PortionFormat	Format for replacing text portion. If null then will be used format of the first character of the found string

getAllTextBoxes(IBaseSlide slide)

public static ITextFrame[] getAllTextBoxes(IBaseSlide slide)

Returns all text frames on a slide in a PPTX presentation.

Parameters:

Parameter	Type	Description
slide	IBaseSlide	Scanned slide.

Returns: com.aspose.slides.ITextFrame[] - Array of TextFrame objects.

getAllTextFrames(IPresentation pres, boolean withMasters)

public static ITextFrame[] getAllTextFrames(IPresentation pres, boolean withMasters)

Returns all text frames in a PPTX presentation.

Parameters:

Parameter	Type	Description
pres	IPresentation	Scanned presentation.
withMasters	boolean	Determines whether master slides should be scanned.

Returns: com.aspose.slides.ITextFrame[] - Array of TextFrame objects.