Package org.apache.poi.hpsf
Class DocumentSummaryInformation
- java.lang.Object
-
- org.apache.poi.hpsf.PropertySet
-
- org.apache.poi.hpsf.DocumentSummaryInformation
-
public class DocumentSummaryInformation extends PropertySet
Convenience class representing a DocumentSummary Information stream in a Microsoft Office document.- See Also:
SummaryInformation
-
-
Field Summary
Fields Modifier and Type Field Description static StringDEFAULT_STREAM_NAMEThe document name a document summary information stream usually has in a POIFS filesystem.static ClassID[]FORMAT_IDThe DocumentSummaryInformation's first and second sections' format ID.-
Fields inherited from class org.apache.poi.hpsf.PropertySet
OS_MACINTOSH, OS_WIN16, OS_WIN32
-
-
Constructor Summary
Constructors Constructor Description DocumentSummaryInformation()Creates an emptyDocumentSummaryInformation.DocumentSummaryInformation(InputStream stream)Creates aDocumentSummaryInformationinstance from anInputStreamin the Horrible Property Set Format.DocumentSummaryInformation(PropertySet ps)Creates aDocumentSummaryInformationfrom a givenPropertySet.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description intgetApplicationVersion()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.intgetByteCount()Returns the byte count or 0 if theDocumentSummaryInformationdoes not contain a byte count.StringgetCategory()Returns the category (ornull).intgetCharCountWithSpaces()Returns the character count including whitespace, or 0 if theDocumentSummaryInformationdoes not contain this char count.StringgetCompany()Returns the company (ornull).StringgetContentStatus()Gets the content status of the file (ornull).StringgetContentType()Gets the content type of the file (ornull).CustomPropertiesgetCustomProperties()Gets the custom properties.byte[]getDocparts()Returns the doc parts (ornull) when this method is implemented.StringgetDocumentVersion()Gets the document version as a string, which is normally unset and empty (ornull).byte[]getHeadingPair()Returns the heading pair (ornull) when this method is implemented.intgetHiddenCount()Returns the hidden count or 0 if theDocumentSummaryInformationdoes not contain a hidden count.booleangetHyperlinksChanged()Get if the User Defined Property Set has been updated outside of the Application.StringgetLanguage()Gets the document language, which is normally unset and empty (ornull).intgetLineCount()Returns the line count or 0 if theDocumentSummaryInformationdoes not contain a line count.booleangetLinksDirty()Returnstrueif the custom links are dirty.StringgetManager()Returns the manager (ornull).intgetMMClipCount()Returns the mmclip count or 0 if theDocumentSummaryInformationdoes not contain a mmclip count.intgetNoteCount()Returns the note count or 0 if theDocumentSummaryInformationdoes not contain a note count.intgetParCount()Returns the par count or 0 if theDocumentSummaryInformationdoes not contain a par count.StringgetPresentationFormat()Returns the presentation format (ornull).PropertyIDMapgetPropertySetIDMap()The id to name mapping of the properties in this set.booleangetScale()Returnstruewhen scaling of the thumbnail is desired,falseif cropping is desired.intgetSlideCount()Returns the slide count or 0 if theDocumentSummaryInformationdoes not contain a slide count.byte[]getVBADigitalSignature()Returns the VBA digital signature for the VBA project embedded in the document (ornull).voidremoveApplicationVersion()Removes the Application VersionvoidremoveByteCount()Removes the byte count.voidremoveCategory()Removes the category.voidremoveCharCountWithSpaces()Removes the character countvoidremoveCompany()Removes the company.voidremoveContentStatus()Removes the content status of the filevoidremoveContentType()Removes the content type of the filevoidremoveCustomProperties()Removes the custom properties.voidremoveDocparts()Removes the doc parts.voidremoveDocumentVersion()Removes the document version stringvoidremoveHeadingPair()Removes the heading pair.voidremoveHiddenCount()Removes the hidden count.voidremoveHyperlinksChanged()Removes the flag for if the User Defined Property Set has been updated outside of the Application.voidremoveLanguage()Removes the document languagevoidremoveLineCount()Removes the line count.voidremoveLinksDirty()Removes the links dirty.voidremoveManager()Removes the manager.voidremoveMMClipCount()Removes the mmclip count.voidremoveNoteCount()Removes the noteCount.voidremoveParCount()Removes the par count.voidremovePresentationFormat()Removes the presentation format.voidremoveScale()Removes the scale.voidremoveSlideCount()Removes the slide count.voidremoveVBADigitalSignature()Removes 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, hashCode, isDocumentSummaryInformation, isPropertySetStream, isPropertySetStream, isSummaryInformation, setByteOrder, setClassID, setFormat, setOSVersion, toInputStream, toString, wasNull, write, write
-
-
-
-
Field Detail
-
DEFAULT_STREAM_NAME
public static final String DEFAULT_STREAM_NAME
The document name a document summary information stream usually has in a POIFS filesystem.- See Also:
- Constant Field Values
-
FORMAT_ID
public static final ClassID[] FORMAT_ID
The DocumentSummaryInformation's first and second sections' format ID.
-
-
Constructor Detail
-
DocumentSummaryInformation
public DocumentSummaryInformation()
Creates an emptyDocumentSummaryInformation.
-
DocumentSummaryInformation
public DocumentSummaryInformation(PropertySet ps) throws UnexpectedPropertySetTypeException
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, IOException
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:
IOException- if theInputStreamcannot be accessed as needed.NoPropertySetStreamException- if the input stream does not contain a property set.
-
-
Method Detail
-
getPropertySetIDMap
public PropertyIDMap 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
public String getCategory()
Returns the category (ornull).- Returns:
- The category value
-
setCategory
public void setCategory(String category)
Sets the category.- Parameters:
category- The category to set.
-
removeCategory
public void removeCategory()
Removes the category.
-
getPresentationFormat
public String getPresentationFormat()
Returns the presentation format (ornull).- Returns:
- The presentation format value
-
setPresentationFormat
public void setPresentationFormat(String presentationFormat)
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
public String getManager()
Returns the manager (ornull).- Returns:
- The manager value
-
setManager
public void setManager(String manager)
Sets the manager.- Parameters:
manager- The manager to set.
-
removeManager
public void removeManager()
Removes the manager.
-
getCompany
public String getCompany()
Returns the company (ornull).- Returns:
- The company value
-
setCompany
public void setCompany(String company)
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
public String getContentType()
Gets the content type of the file (ornull).- Returns:
- the content type of the file
-
setContentType
public void setContentType(String type)
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
public String getContentStatus()
Gets the content status of the file (ornull).- Returns:
- the content status of the file
-
setContentStatus
public void setContentStatus(String status)
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
public String getLanguage()
Gets the document language, which is normally unset and empty (ornull).- Returns:
- the document language
-
setLanguage
public void setLanguage(String language)
Set the document language- Parameters:
language- the document language
-
removeLanguage
public void removeLanguage()
Removes the document language
-
getDocumentVersion
public String getDocumentVersion()
Gets the document version as a string, which is normally unset and empty (ornull).- Returns:
- the document verion
-
setDocumentVersion
public void setDocumentVersion(String version)
Sets the document version string- Parameters:
version- the document version string
-
removeDocumentVersion
public void removeDocumentVersion()
Removes the document version string
-
getCustomProperties
public CustomProperties getCustomProperties()
Gets the custom properties.- Returns:
- The custom properties.
-
setCustomProperties
public void setCustomProperties(CustomProperties customProperties)
Sets the custom properties.- Parameters:
customProperties- The custom properties
-
removeCustomProperties
public void removeCustomProperties()
Removes the custom properties.
-
-