org.apache.poi.xslf.usermodel

Class XSLFGroupShape

java.lang.Object

org.apache.poi.xslf.usermodel.XSLFShape

org.apache.poi.xslf.usermodel.XSLFGroupShape

All Implemented Interfaces:

java.lang.Iterable<XSLFShape>, XSLFShapeContainer

@Beta
public class XSLFGroupShape
extends XSLFShape
implements XSLFShapeContainer

Represents a group shape that consists of many shapes grouped together.

Method Summary

Modifier and Type	Method and Description
void	clear() Removes all of the elements from this container (optional operation).
XSLFAutoShape	createAutoShape() create a new shape with a predefined geometry and add it to this shape container
XSLFConnectorShape	createConnector() create a connector
XSLFFreeformShape	createFreeform() create a new shape with a custom geometry
XSLFGroupShape	createGroup() create a group of shapes belonging to this container
XSLFPictureShape	createPicture(int pictureIndex) create a picture belonging to this container
XSLFTextBox	createTextBox() create a text box
void	draw(java.awt.Graphics2D graphics) Draw this shape into the supplied canvas
java.awt.geom.Rectangle2D	getAnchor()
boolean	getFlipHorizontal() Whether the shape is horizontally flipped
boolean	getFlipVertical() Whether the shape is vertically flipped
java.awt.geom.Rectangle2D	getInteriorAnchor()
double	getRotation() Rotation angle in degrees
int	getShapeId() Returns a unique identifier for this shape within the current document.
java.lang.String	getShapeName()
XSLFShape[]	getShapes() Returns an array containing all of the elements in this container in proper sequence (from first to last element).
org.openxmlformats.schemas.presentationml.x2006.main.CTGroupShape	getXmlObject()
java.util.Iterator<XSLFShape>	iterator() Returns an iterator over the shapes in this sheet
boolean	removeShape(XSLFShape xShape) Remove the specified shape from this group
void	setAnchor(java.awt.geom.Rectangle2D anchor)
void	setFlipHorizontal(boolean flip)
void	setFlipVertical(boolean flip) Whether the shape is vertically flipped
void	setInteriorAnchor(java.awt.geom.Rectangle2D anchor)
void	setRotation(double theta) Rotate this shape.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

getXmlObject

public org.openxmlformats.schemas.presentationml.x2006.main.CTGroupShape getXmlObject()

Specified by:

getXmlObject in class XSLFShape

Returns:

the xml bean holding this shape's data

getAnchor

public java.awt.geom.Rectangle2D getAnchor()

Specified by:

getAnchor in class XSLFShape

Returns:

the position of this shape within the drawing canvas. The coordinates are expressed in points

setAnchor

public void setAnchor(java.awt.geom.Rectangle2D anchor)

Specified by:

setAnchor in class XSLFShape

Parameters:

anchor - the position of this shape within the drawing canvas. The coordinates are expressed in points

getInteriorAnchor

public java.awt.geom.Rectangle2D getInteriorAnchor()

Returns:

the coordinates of the child extents rectangle used for calculations of grouping, scaling, and rotation behavior of shapes placed within a group.

setInteriorAnchor

public void setInteriorAnchor(java.awt.geom.Rectangle2D anchor)

Parameters:

anchor - the coordinates of the child extents rectangle used for calculations of grouping, scaling, and rotation behavior of shapes placed within a group.

getShapes

public XSLFShape[] getShapes()

Description copied from interface: XSLFShapeContainer

Returns an array containing all of the elements in this container in proper sequence (from first to last element).

Specified by:

getShapes in interface XSLFShapeContainer

Returns:

child shapes contained witin this group

iterator

public java.util.Iterator<XSLFShape> iterator()

Returns an iterator over the shapes in this sheet

Specified by:

iterator in interface java.lang.Iterable<XSLFShape>

Returns:

an iterator over the shapes in this sheet

removeShape

public boolean removeShape(XSLFShape xShape)

Remove the specified shape from this group

Specified by:

removeShape in interface XSLFShapeContainer

Parameters:

xShape - shape to be removed from this sheet, if present

Returns:

true if this sheet contained the specified element

getShapeName

public java.lang.String getShapeName()

Specified by:

getShapeName in class XSLFShape

Returns:

human-readable name of this shape, e.g. "Rectange 3"

getShapeId

public int getShapeId()

Description copied from class: XSLFShape

Returns a unique identifier for this shape within the current document. This ID may be used to assist in uniquely identifying this object so that it can be referred to by other parts of the document.

If multiple objects within the same document share the same id attribute value, then the document shall be considered non-conformant.

Specified by:

getShapeId in class XSLFShape

Returns:

unique id of this shape

createAutoShape

public XSLFAutoShape createAutoShape()

Description copied from interface: XSLFShapeContainer

create a new shape with a predefined geometry and add it to this shape container

Specified by:

createAutoShape in interface XSLFShapeContainer

createFreeform

public XSLFFreeformShape createFreeform()

Description copied from interface: XSLFShapeContainer

create a new shape with a custom geometry

Specified by:

createFreeform in interface XSLFShapeContainer

createTextBox

public XSLFTextBox createTextBox()

Description copied from interface: XSLFShapeContainer

create a text box

Specified by:

createTextBox in interface XSLFShapeContainer

createConnector

public XSLFConnectorShape createConnector()

Description copied from interface: XSLFShapeContainer

create a connector

Specified by:

createConnector in interface XSLFShapeContainer

createGroup

public XSLFGroupShape createGroup()

Description copied from interface: XSLFShapeContainer

create a group of shapes belonging to this container

Specified by:

createGroup in interface XSLFShapeContainer

createPicture

public XSLFPictureShape createPicture(int pictureIndex)

Description copied from interface: XSLFShapeContainer

create a picture belonging to this container

Specified by:

createPicture in interface XSLFShapeContainer

setFlipHorizontal

public void setFlipHorizontal(boolean flip)

Specified by:

setFlipHorizontal in class XSLFShape

Parameters:

flip - whether the shape is horizontally flipped

setFlipVertical

public void setFlipVertical(boolean flip)

Description copied from class: XSLFShape

Whether the shape is vertically flipped

Specified by:

setFlipVertical in class XSLFShape

Parameters:

flip - whether the shape is vertically flipped

getFlipHorizontal

public boolean getFlipHorizontal()

Description copied from class: XSLFShape

Whether the shape is horizontally flipped

Specified by:

getFlipHorizontal in class XSLFShape

Returns:

whether the shape is horizontally flipped

getFlipVertical

public boolean getFlipVertical()

Description copied from class: XSLFShape

Whether the shape is vertically flipped

Specified by:

getFlipVertical in class XSLFShape

Returns:

whether the shape is vertically flipped

setRotation

public void setRotation(double theta)

Description copied from class: XSLFShape

Rotate this shape.

Positive angles are clockwise (i.e., towards the positive y axis); negative angles are counter-clockwise (i.e., towards the negative y axis).

Specified by:

setRotation in class XSLFShape

Parameters:

theta - the rotation angle in degrees.

getRotation

public double getRotation()

Description copied from class: XSLFShape

Rotation angle in degrees

Positive angles are clockwise (i.e., towards the positive y axis); negative angles are counter-clockwise (i.e., towards the negative y axis).

Specified by:

getRotation in class XSLFShape

Returns:

rotation angle in degrees

draw

public void draw(java.awt.Graphics2D graphics)

Description copied from class: XSLFShape

Draw this shape into the supplied canvas

Specified by:

draw in class XSLFShape

Parameters:

graphics - the graphics to draw into

clear

public void clear()

Removes all of the elements from this container (optional operation). The container will be empty after this call returns.

Specified by:

clear in interface XSLFShapeContainer