public final class XSSFVMLDrawing extends POIXMLDocumentPart
In Excel 2007 VML drawings are used to describe properties of cell comments, although the spec says that VML is deprecated:
The VML format is a legacy format originally introduced with Office 2000 and is included and fully defined in this Standard for backwards compatibility reasons. The DrawingML format is a newer and richer format created with the goal of eventually replacing any uses of VML in the Office Open XML formats. VML should be considered a deprecated format included in Office Open XML for legacy reasons only and new applications that need a file format for drawings are strongly encouraged to use preferentially DrawingML
Warning - Excel is known to put invalid XML into these files! For example, >br< without being closed or escaped crops up.
See 6.4 VML - SpreadsheetML Drawing in Office Open XML Part 4 - Markup Language Reference.pdfPOIXMLDocumentPart.RelationPart| Modifier | Constructor and Description |
|---|---|
protected |
XSSFVMLDrawing()
Create a new SpreadsheetML drawing
|
protected |
XSSFVMLDrawing(PackagePart part)
Construct a SpreadsheetML drawing from a package part
|
protected |
XSSFVMLDrawing(PackagePart part,
PackageRelationship rel)
Deprecated.
in POI 3.14, scheduled for removal in POI 3.16
|
| Modifier and Type | Method and Description |
|---|---|
protected void |
commit()
Save the content in the underlying package part.
|
protected com.microsoft.schemas.vml.CTShape |
findCommentShape(int row,
int col)
Find a shape with ClientData of type "NOTE" and the specified row and column
|
protected java.util.List<org.apache.xmlbeans.XmlObject> |
getItems() |
protected com.microsoft.schemas.vml.CTShape |
newCommentShape() |
protected void |
read(java.io.InputStream is) |
protected boolean |
removeCommentShape(int row,
int col) |
protected void |
write(java.io.OutputStream out) |
_invokeOnDocumentRead, addRelation, addRelation, createRelationship, createRelationship, createRelationship, getPackagePart, getPackageRelationship, getParent, getRelationById, getRelationId, getRelationParts, getRelations, getTargetPart, onDocumentCreate, onDocumentRead, onDocumentRemove, onSave, prepareForCommit, read, rebase, removeRelation, removeRelation, toStringprotected XSSFVMLDrawing()
XSSFSheet.createDrawingPatriarch()protected XSSFVMLDrawing(PackagePart part) throws java.io.IOException, org.apache.xmlbeans.XmlException
part - the package part holding the drawing data,
the content type must be application/vnd.openxmlformats-officedocument.drawing+xmljava.io.IOExceptionorg.apache.xmlbeans.XmlException@Deprecated protected XSSFVMLDrawing(PackagePart part, PackageRelationship rel) throws java.io.IOException, org.apache.xmlbeans.XmlException
java.io.IOExceptionorg.apache.xmlbeans.XmlExceptionprotected void read(java.io.InputStream is)
throws java.io.IOException,
org.apache.xmlbeans.XmlException
java.io.IOExceptionorg.apache.xmlbeans.XmlExceptionprotected java.util.List<org.apache.xmlbeans.XmlObject> getItems()
protected void write(java.io.OutputStream out)
throws java.io.IOException
java.io.IOExceptionprotected void commit()
throws java.io.IOException
POIXMLDocumentPart
protected void commit() throws IOException {
PackagePart part = getPackagePart();
OutputStream out = part.getOutputStream();
XmlObject bean = getXmlBean(); //the "model" which holds changes in memory
bean.save(out, DEFAULT_XML_OPTIONS);
out.close();
}
commit in class POIXMLDocumentPartjava.io.IOException - a subclass may throw an IOException if the changes can't be committedprotected com.microsoft.schemas.vml.CTShape newCommentShape()
protected com.microsoft.schemas.vml.CTShape findCommentShape(int row,
int col)
nullprotected boolean removeCommentShape(int row,
int col)