org.apache.poi.xslf.usermodel

Class XSLFPictureShape

java.lang.Object

org.apache.poi.xslf.usermodel.XSLFShape

org.apache.poi.xslf.usermodel.XSLFSimpleShape

org.apache.poi.xslf.usermodel.XSLFPictureShape

All Implemented Interfaces:

IAdjustableShape, PictureShape<XSLFShape,XSLFTextParagraph>, PlaceableShape<XSLFShape,XSLFTextParagraph>, Shape<XSLFShape,XSLFTextParagraph>, SimpleShape<XSLFShape,XSLFTextParagraph>

@Beta
public class XSLFPictureShape
extends XSLFSimpleShape
implements PictureShape<XSLFShape,XSLFTextParagraph>

Represents a picture shape

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.poi.xslf.usermodel.XSLFShape

XSLFShape.ReparseFactory<T extends org.apache.xmlbeans.XmlObject>

Method Summary

Modifier and Type	Method and Description
static XSLFPictureShape	addSvgImage(XSLFSheet sheet, XSLFPictureData svgPic, PictureData.PictureType previewType, Rectangle2D anchor) Convenience method for adding SVG images, which generates the preview image
PictureData	getAlternativePictureData()
String	getAudioFileLink()
protected org.openxmlformats.schemas.drawingml.x2006.main.CTBlip	getBlip()
protected org.openxmlformats.schemas.drawingml.x2006.main.CTBlipFillProperties	getBlipFill()
protected String	getBlipId()
protected String	getBlipLink()
Insets	getClipping()
String	getName()
XSLFPictureData	getPictureData() Return the data on the (internal) picture.
URI	getPictureLink() For an external linked picture, return the last-seen path to the picture.
XSLFPictureData	getSvgImage()
String	getVideoFileLink()
boolean	isAudioFile()
boolean	isExternalLinkedPicture() Is this an internal picture (image data included within the PowerPoint file), or an external linked picture (image lives outside)?
boolean	isVideoFile()
boolean	setName(String name)
void	setPlaceholder(Placeholder placeholder)
void	setSvgImage(XSLFPictureData svgPic) Add a SVG image reference

Methods inherited from class org.apache.poi.xslf.usermodel.XSLFSimpleShape

createHyperlink, getAdjustValue, getAnchor, getFillColor, getFillStyle, getFlipHorizontal, getFlipVertical, getGeometry, getHyperlink, getLineCap, getLineColor, getLineCompound, getLineDash, getLineDecoration, getLineHeadDecoration, getLineHeadLength, getLineHeadWidth, getLinePaint, getLineTailDecoration, getLineTailLength, getLineTailWidth, getLineWidth, getRotation, getShadow, getShapeType, getStrokeStyle, getXfrm, setAnchor, setFillColor, setFlipHorizontal, setFlipVertical, setLineCap, setLineColor, setLineCompound, setLineDash, setLineHeadDecoration, setLineHeadLength, setLineHeadWidth, setLineTailDecoration, setLineTailLength, setLineTailWidth, setLineWidth, setRotation, setShapeType, setStrokeStyle

Methods inherited from class org.apache.poi.xslf.usermodel.XSLFShape

draw, fetchShapeProperty, getBgPr, getBgRef, getChild, getCNvPr, getFillPaint, getGrpSpPr, getParent, getPlaceholder, getPlaceholderDetails, getShapeId, getShapeName, getShapeProperties, getSheet, getSpStyle, getXmlObject, isPlaceholder, selectPaint, selectPaint, selectPaint, selectPaint, selectPaint, selectPaint, selectProperty, setParent

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.poi.sl.usermodel.SimpleShape

createHyperlink, getFillColor, getFillStyle, getGeometry, getHyperlink, getLineDecoration, getPlaceholder, getPlaceholderDetails, getShadow, getShapeType, getStrokeStyle, isPlaceholder, setFillColor, setShapeType, setStrokeStyle

Methods inherited from interface org.apache.poi.sl.usermodel.Shape

draw, getAnchor, getParent, getShapeId, getShapeName, getSheet

Methods inherited from interface org.apache.poi.sl.draw.geom.IAdjustableShape

getAdjustValue

Methods inherited from interface org.apache.poi.sl.usermodel.PlaceableShape

getAnchor, getFlipHorizontal, getFlipVertical, getParent, getRotation, getSheet, setAnchor, setFlipHorizontal, setFlipVertical, setRotation

Method Detail

isExternalLinkedPicture

public boolean isExternalLinkedPicture()

Is this an internal picture (image data included within the PowerPoint file), or an external linked picture (image lives outside)?

getPictureData

public XSLFPictureData getPictureData()

Return the data on the (internal) picture. For an external linked picture, will return null

Specified by:

getPictureData in interface PictureShape<XSLFShape,XSLFTextParagraph>

setPlaceholder

public void setPlaceholder(Placeholder placeholder)

Specified by:

setPlaceholder in interface SimpleShape<XSLFShape,XSLFTextParagraph>

Overrides:

setPlaceholder in class XSLFShape

See Also:

PlaceholderDetails.setPlaceholder(Placeholder)

getPictureLink

public URI getPictureLink()

For an external linked picture, return the last-seen path to the picture. For an internal picture, returns null.

getBlipFill

protected org.openxmlformats.schemas.drawingml.x2006.main.CTBlipFillProperties getBlipFill()

getBlip

protected org.openxmlformats.schemas.drawingml.x2006.main.CTBlip getBlip()

getBlipLink

protected String getBlipLink()

getBlipId

protected String getBlipId()

getClipping

public Insets getClipping()

Specified by:

getClipping in interface PictureShape<XSLFShape,XSLFTextParagraph>

setSvgImage

public void setSvgImage(XSLFPictureData svgPic)

Add a SVG image reference

Parameters:

svgPic - a previously imported svg image

Since:

POI 4.1.0

getAlternativePictureData

public PictureData getAlternativePictureData()

Specified by:

getAlternativePictureData in interface PictureShape<XSLFShape,XSLFTextParagraph>

getName

public String getName()

Returns:

picture name, can be null

Since:

POI 5.1.0

setName

public boolean setName(String name)

Parameters:

name - picture name

Returns:

returns true if the name was set

Since:

POI 5.1.0

getSvgImage

public XSLFPictureData getSvgImage()

Returns:

SVG image data -- can return null if no SVG image is found

addSvgImage

public static XSLFPictureShape addSvgImage(XSLFSheet sheet,
                                           XSLFPictureData svgPic,
                                           PictureData.PictureType previewType,
                                           Rectangle2D anchor)
                                    throws IOException

Convenience method for adding SVG images, which generates the preview image

Parameters:

sheet - the sheet to add

svgPic - the svg picture to add

previewType - the preview picture type or null (defaults to PNG) - currently only JPEG,GIF,PNG are allowed

anchor - the image anchor (for calculating the preview image size) or null (the preview size is taken from the svg picture bounds)

Throws:

IOException

Since:

POI 4.1.0

isVideoFile

public boolean isVideoFile()

Returns:

boolean; true if the picture is a video

Since:

POI 5.2.0

getVideoFileLink

public String getVideoFileLink()

Returns:

the link ID for the video file

Since:

POI 5.2.0

isAudioFile

public boolean isAudioFile()

Returns:

boolean; true if the picture is an audio

Since:

POI 5.2.4

getAudioFileLink

public String getAudioFileLink()

Returns:

the link ID for the audio file

Since:

POI 5.2.4