Package org.apache.poi.sl.usermodel
Interface ObjectShape<S extends Shape<S,P>,P extends TextParagraph<S,P,? extends TextRun>>
- All Superinterfaces:
PlaceableShape<S,,P> Shape<S,P>
- All Known Implementing Classes:
HSLFObjectShape,XSLFObjectShape
public interface ObjectShape<S extends Shape<S,P>,P extends TextParagraph<S,P,? extends TextRun>>
extends Shape<S,P>, PlaceableShape<S,P>
An shape which references an embedded OLE object
- Since:
- POI 4.0.0
-
Method Summary
Modifier and TypeMethodDescriptionReturns the full name of the embedded object, e.g.Returns the picture data for this picture.Returns the ProgID that stores the OLE Programmatic Identifier.default InputStreamReads the ole data as stream - the application specific stream is served Theraw dataserves the outer/wrapped object, which is usually aPOIFSFileSystemstream, whereas this method return the unwrapped entrydefault InputStreamConvenience method to return the raw data asInputStreamupdateObjectData(ObjectMetaData.Application application, ObjectMetaData metaData) Updates the ole data.Methods inherited from interface org.apache.poi.sl.usermodel.PlaceableShape
getAnchor, getFlipHorizontal, getFlipVertical, getParent, getRotation, getSheet, setAnchor, setFlipHorizontal, setFlipVertical, setRotationMethods inherited from interface org.apache.poi.sl.usermodel.Shape
draw, getAnchor, getParent, getShapeId, getShapeName, getSheet
-
Method Details
-
getPictureData
PictureData getPictureData()Returns the picture data for this picture.- Returns:
- the picture data for this picture.
-
getProgId
String getProgId()Returns the ProgID that stores the OLE Programmatic Identifier. A ProgID is a string that uniquely identifies a given object, for example, "Word.Document.8" or "Excel.Sheet.8".- Returns:
- the ProgID
-
getFullName
String getFullName()Returns the full name of the embedded object, e.g. "Microsoft Word Document" or "Microsoft Office Excel Worksheet".- Returns:
- the full name of the embedded object
-
updateObjectData
OutputStream updateObjectData(ObjectMetaData.Application application, ObjectMetaData metaData) throws IOException Updates the ole data. If there wasn't an object registered before, a new ole embedding is registered in the parent slideshow.For HSLF this needs to be a
POIFSFileSystemstream.- Parameters:
application- a preset application enummetaData- or a custom metaData object, can benullif the application has been set- Returns:
- an
OutputStreamwhich receives the new data, the data will be persisted onclose() - Throws:
IOException- if the linked object data couldn't be found or a new object data couldn't be initialized
-
readObjectData
Reads the ole data as stream - the application specific stream is served Theraw dataserves the outer/wrapped object, which is usually aPOIFSFileSystemstream, whereas this method return the unwrapped entry- Returns:
- an
InputStreamwhich serves the object data - Throws:
IOException- if the linked object data couldn't be found
-
readObjectDataRaw
Convenience method to return the raw data asInputStream- Returns:
- the raw data stream
- Throws:
IOException- if the data couldn't be retrieved
-
getObjectData
ObjectData getObjectData()- Returns:
- the data object
-