Package org.apache.poi.hpsf
Class DocumentSummaryInformation
java.lang.Object
org.apache.poi.hpsf.PropertySet
org.apache.poi.hpsf.DocumentSummaryInformation
Convenience class representing a DocumentSummary Information stream in a
Microsoft Office document.
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringThe document name a document summary information stream usually has in a POIFS filesystem.static final ClassID[]Fields inherited from class org.apache.poi.hpsf.PropertySet
OS_MACINTOSH, OS_WIN16, OS_WIN32 -
Constructor Summary
ConstructorsConstructorDescriptionCreates an emptyDocumentSummaryInformation.Creates aDocumentSummaryInformationinstance from anInputStreamin the Horrible Property Set Format.Creates aDocumentSummaryInformationfrom a givenPropertySet. -
Method Summary
Modifier and TypeMethodDescriptionintGets the version of the Application which wrote the Property set, stored with the two high order bytes having the major version number, and the two low order bytes the minor version number.intReturns the byte count or 0 if theDocumentSummaryInformationdoes not contain a byte count.Returns the category (ornull).intReturns the character count including whitespace, or 0 if theDocumentSummaryInformationdoes not contain this char count.Returns the company (ornull).Gets the content status of the file (ornull).Gets the content type of the file (ornull).Gets the custom properties.byte[]Returns the doc parts (ornull) when this method is implemented.Gets the document version as a string, which is normally unset and empty (ornull).byte[]Returns the heading pair (ornull) when this method is implemented.intReturns the hidden count or 0 if theDocumentSummaryInformationdoes not contain a hidden count.booleanGet if the User Defined Property Set has been updated outside of the Application.Gets the document language, which is normally unset and empty (ornull).intReturns the line count or 0 if theDocumentSummaryInformationdoes not contain a line count.booleanReturnstrueif the custom links are dirty.Returns the manager (ornull).intReturns the mmclip count or 0 if theDocumentSummaryInformationdoes not contain a mmclip count.intReturns the note count or 0 if theDocumentSummaryInformationdoes not contain a note count.intReturns the par count or 0 if theDocumentSummaryInformationdoes not contain a par count.Returns the presentation format (ornull).The id to name mapping of the properties in this set.booleangetScale()Returnstruewhen scaling of the thumbnail is desired,falseif cropping is desired.intReturns the slide count or 0 if theDocumentSummaryInformationdoes not contain a slide count.byte[]Returns the VBA digital signature for the VBA project embedded in the document (ornull).voidRemoves the Application VersionvoidRemoves the byte count.voidRemoves the category.voidRemoves the character countvoidRemoves the company.voidRemoves the content status of the filevoidRemoves the content type of the filevoidRemoves the custom properties.voidRemoves the doc parts.voidRemoves the document version stringvoidRemoves the heading pair.voidRemoves the hidden count.voidRemoves the flag for if the User Defined Property Set has been updated outside of the Application.voidRemoves the document languagevoidRemoves the line count.voidRemoves the links dirty.voidRemoves the manager.voidRemoves the mmclip count.voidRemoves the noteCount.voidRemoves the par count.voidRemoves the presentation format.voidRemoves the scale.voidRemoves the slide count.voidRemoves the VBA Digital SignaturevoidsetApplicationVersion(int version) Sets the Application version, which must be a 4 byte int with the two high order bytes having the major version number, and the two low order bytes the minor version number.voidsetByteCount(int byteCount) Sets the byte count.voidsetCategory(String category) Sets the category.voidsetCharCountWithSpaces(int count) Sets the character count including whitespacevoidsetCompany(String company) Sets the company.voidsetContentStatus(String status) Sets the content status of the filevoidsetContentType(String type) Sets the content type of the filevoidsetCustomProperties(CustomProperties customProperties) Sets the custom properties.voidsetDocparts(byte[] docparts) Sets the doc parts.voidsetDocumentVersion(String version) Sets the document version stringvoidsetHeadingPair(byte[] headingPair) Sets the heading pair.voidsetHiddenCount(int hiddenCount) Sets the hidden count.voidsetHyperlinksChanged(boolean changed) Set the flag for if the User Defined Property Set has been updated outside of the Application.voidsetLanguage(String language) Set the document languagevoidsetLineCount(int lineCount) Sets the line count.voidsetLinksDirty(boolean linksDirty) Sets the linksDirty.voidsetManager(String manager) Sets the manager.voidsetMMClipCount(int mmClipCount) Sets the mmclip count.voidsetNoteCount(int noteCount) Sets the note count.voidsetParCount(int parCount) Sets the par count.voidsetPresentationFormat(String presentationFormat) Sets the presentation format.voidsetScale(boolean scale) Sets the scale.voidsetSlideCount(int slideCount) Sets the slideCount.voidsetVBADigitalSignature(byte[] signature) Sets the VBA digital signature for the VBA project embedded in the document.Methods inherited from class org.apache.poi.hpsf.PropertySet
addSection, clearSections, equals, getByteOrder, getClassID, getFirstSection, getFormat, getOSVersion, getProperties, getProperty, getPropertyStringValue, getSectionCount, getSections, getSingleSection, hashCode, isDocumentSummaryInformation, isPropertySetStream, isPropertySetStream, isSummaryInformation, setByteOrder, setClassID, setFormat, setOSVersion, toInputStream, toString, wasNull, write, write
-
Field Details
-
DEFAULT_STREAM_NAME
The document name a document summary information stream usually has in a POIFS filesystem.- See Also:
-
FORMAT_ID
-
-
Constructor Details
-
DocumentSummaryInformation
public DocumentSummaryInformation()Creates an emptyDocumentSummaryInformation. -
DocumentSummaryInformation
Creates aDocumentSummaryInformationfrom a givenPropertySet.- Parameters:
ps- A property set which should be created from a document summary information stream.- Throws:
UnexpectedPropertySetTypeException- ifpsdoes not contain a document summary information stream.
-
DocumentSummaryInformation
public DocumentSummaryInformation(InputStream stream) throws NoPropertySetStreamException, MarkUnsupportedException, IOException, UnsupportedEncodingException Creates aDocumentSummaryInformationinstance from anInputStreamin the Horrible Property Set Format.The constructor reads the first few bytes from the stream and determines whether it is really a property set stream. If it is, it parses the rest of the stream. If it is not, it resets the stream to its beginning in order to let other components mess around with the data and throws an exception.
- Parameters:
stream- Holds the data making out the property set stream.- Throws:
MarkUnsupportedException- if the stream does not support theInputStream.markSupported()method.IOException- if theInputStreamcannot be accessed as needed.NoPropertySetStreamException- if the input stream does not contain a property set.UnsupportedEncodingException- if a character encoding is not supported.
-
-
Method Details
-
getPropertySetIDMap
Description copied from class:PropertySetThe id to name mapping of the properties in this set.- Overrides:
getPropertySetIDMapin classPropertySet- Returns:
- the id to name mapping of the properties in this set or
nullif not applicable
-
getCategory
Returns the category (ornull).- Returns:
- The category value
-
setCategory
Sets the category.- Parameters:
category- The category to set.
-
removeCategory
public void removeCategory()Removes the category. -
getPresentationFormat
Returns the presentation format (ornull).- Returns:
- The presentation format value
-
setPresentationFormat
Sets the presentation format.- Parameters:
presentationFormat- The presentation format to set.
-
removePresentationFormat
public void removePresentationFormat()Removes the presentation format. -
getByteCount
public int getByteCount()Returns the byte count or 0 if theDocumentSummaryInformationdoes not contain a byte count.- Returns:
- The byteCount value
-
setByteCount
public void setByteCount(int byteCount) Sets the byte count.- Parameters:
byteCount- The byte count to set.
-
removeByteCount
public void removeByteCount()Removes the byte count. -
getLineCount
public int getLineCount()Returns the line count or 0 if theDocumentSummaryInformationdoes not contain a line count.- Returns:
- The line count value
-
setLineCount
public void setLineCount(int lineCount) Sets the line count.- Parameters:
lineCount- The line count to set.
-
removeLineCount
public void removeLineCount()Removes the line count. -
getParCount
public int getParCount()Returns the par count or 0 if theDocumentSummaryInformationdoes not contain a par count.- Returns:
- The par count value
-
setParCount
public void setParCount(int parCount) Sets the par count.- Parameters:
parCount- The par count to set.
-
removeParCount
public void removeParCount()Removes the par count. -
getSlideCount
public int getSlideCount()Returns the slide count or 0 if theDocumentSummaryInformationdoes not contain a slide count.- Returns:
- The slide count value
-
setSlideCount
public void setSlideCount(int slideCount) Sets the slideCount.- Parameters:
slideCount- The slide count to set.
-
removeSlideCount
public void removeSlideCount()Removes the slide count. -
getNoteCount
public int getNoteCount()Returns the note count or 0 if theDocumentSummaryInformationdoes not contain a note count.- Returns:
- The note count value
-
setNoteCount
public void setNoteCount(int noteCount) Sets the note count.- Parameters:
noteCount- The note count to set.
-
removeNoteCount
public void removeNoteCount()Removes the noteCount. -
getHiddenCount
public int getHiddenCount()Returns the hidden count or 0 if theDocumentSummaryInformationdoes not contain a hidden count.- Returns:
- The hidden count value
-
setHiddenCount
public void setHiddenCount(int hiddenCount) Sets the hidden count.- Parameters:
hiddenCount- The hidden count to set.
-
removeHiddenCount
public void removeHiddenCount()Removes the hidden count. -
getMMClipCount
public int getMMClipCount()Returns the mmclip count or 0 if theDocumentSummaryInformationdoes not contain a mmclip count.- Returns:
- The mmclip count value
-
setMMClipCount
public void setMMClipCount(int mmClipCount) Sets the mmclip count.- Parameters:
mmClipCount- The mmclip count to set.
-
removeMMClipCount
public void removeMMClipCount()Removes the mmclip count. -
getScale
public boolean getScale()Returnstruewhen scaling of the thumbnail is desired,falseif cropping is desired.- Returns:
- The scale value
-
setScale
public void setScale(boolean scale) Sets the scale.- Parameters:
scale- The scale to set.
-
removeScale
public void removeScale()Removes the scale. -
getHeadingPair
public byte[] getHeadingPair()Returns the heading pair (or
null) when this method is implemented. Please note that the return type is likely to change!- Returns:
- The heading pair value
-
setHeadingPair
public void setHeadingPair(byte[] headingPair) Sets the heading pair.- Parameters:
headingPair- The heading pair to set.
-
removeHeadingPair
public void removeHeadingPair()Removes the heading pair. -
getDocparts
public byte[] getDocparts()Returns the doc parts (or
null) when this method is implemented. Please note that the return type is likely to change!- Returns:
- The doc parts value
-
setDocparts
public void setDocparts(byte[] docparts) Sets the doc parts.- Parameters:
docparts- The doc parts to set.
-
removeDocparts
public void removeDocparts()Removes the doc parts. -
getManager
Returns the manager (ornull).- Returns:
- The manager value
-
setManager
Sets the manager.- Parameters:
manager- The manager to set.
-
removeManager
public void removeManager()Removes the manager. -
getCompany
Returns the company (ornull).- Returns:
- The company value
-
setCompany
Sets the company.- Parameters:
company- The company to set.
-
removeCompany
public void removeCompany()Removes the company. -
getLinksDirty
public boolean getLinksDirty()Returnstrueif the custom links are dirty.- Returns:
- The links dirty value
-
setLinksDirty
public void setLinksDirty(boolean linksDirty) Sets the linksDirty.- Parameters:
linksDirty- The links dirty value to set.
-
removeLinksDirty
public void removeLinksDirty()Removes the links dirty. -
getCharCountWithSpaces
public int getCharCountWithSpaces()Returns the character count including whitespace, or 0 if theDocumentSummaryInformationdoes not contain this char count.This is the whitespace-including version of
SummaryInformation.getCharCount()- Returns:
- The character count or
null
-
setCharCountWithSpaces
public void setCharCountWithSpaces(int count) Sets the character count including whitespace- Parameters:
count- The character count to set.
-
removeCharCountWithSpaces
public void removeCharCountWithSpaces()Removes the character count -
getHyperlinksChanged
public boolean getHyperlinksChanged()Get if the User Defined Property Set has been updated outside of the Application.If it has (true), the hyperlinks should be updated on document load.
- Returns:
- true, if the hyperlinks should be updated on document load
-
setHyperlinksChanged
public void setHyperlinksChanged(boolean changed) Set the flag for if the User Defined Property Set has been updated outside of the Application.- Parameters:
changed- true, if the User Defined Property Set has been updated
-
removeHyperlinksChanged
public void removeHyperlinksChanged()Removes the flag for if the User Defined Property Set has been updated outside of the Application. -
getApplicationVersion
public int getApplicationVersion()Gets the version of the Application which wrote the Property set, stored with the two high order bytes having the major version number, and the two low order bytes the minor version number.This will be 0 if no version is set.
- Returns:
- the Application version
-
setApplicationVersion
public void setApplicationVersion(int version) Sets the Application version, which must be a 4 byte int with the two high order bytes having the major version number, and the two low order bytes the minor version number.- Parameters:
version- the Application version
-
removeApplicationVersion
public void removeApplicationVersion()Removes the Application Version -
getVBADigitalSignature
public byte[] getVBADigitalSignature()Returns the VBA digital signature for the VBA project embedded in the document (ornull).- Returns:
- the VBA digital signature
-
setVBADigitalSignature
public void setVBADigitalSignature(byte[] signature) Sets the VBA digital signature for the VBA project embedded in the document.- Parameters:
signature- VBA Digital Signature for the project
-
removeVBADigitalSignature
public void removeVBADigitalSignature()Removes the VBA Digital Signature -
getContentType
Gets the content type of the file (ornull).- Returns:
- the content type of the file
-
setContentType
Sets the content type of the file- Parameters:
type- the content type of the file
-
removeContentType
public void removeContentType()Removes the content type of the file -
getContentStatus
Gets the content status of the file (ornull).- Returns:
- the content status of the file
-
setContentStatus
Sets the content status of the file- Parameters:
status- the content status of the file
-
removeContentStatus
public void removeContentStatus()Removes the content status of the file -
getLanguage
Gets the document language, which is normally unset and empty (ornull).- Returns:
- the document language
-
setLanguage
Set the document language- Parameters:
language- the document language
-
removeLanguage
public void removeLanguage()Removes the document language -
getDocumentVersion
Gets the document version as a string, which is normally unset and empty (ornull).- Returns:
- the document verion
-
setDocumentVersion
Sets the document version string- Parameters:
version- the document version string
-
removeDocumentVersion
public void removeDocumentVersion()Removes the document version string -
getCustomProperties
Gets the custom properties.- Returns:
- The custom properties.
-
setCustomProperties
Sets the custom properties.- Parameters:
customProperties- The custom properties
-
removeCustomProperties
public void removeCustomProperties()Removes the custom properties.
-