org.apache.poi.xwpf.usermodel

Class XWPFSettings

java.lang.Object

org.apache.poi.POIXMLDocumentPart

org.apache.poi.xwpf.usermodel.XWPFSettings

public class XWPFSettings
extends POIXMLDocumentPart

Field Summary

Fields inherited from class org.apache.poi.POIXMLDocumentPart

DEFAULT_XML_OPTIONS

Constructor Summary

Constructors

Constructor and Description
XWPFSettings()
XWPFSettings(PackagePart part, PackageRelationship rel)

Method Summary

Modifier and Type	Method and Description
long	getZoomPercent() Set zoom. In the zoom tag inside settings.xml file it sets the value of zoom sample snippet from settings.xml
boolean	isEnforcedWith(org.openxmlformats.schemas.wordprocessingml.x2006.main.STDocProtect.Enum editValue) Verifies the documentProtection tag inside settings.xml file if the protection is enforced (w:enforcement="1") and if the kind of protection equals to passed (STDocProtect.Enum editValue) sample snippet from settings.xml
boolean	isTrackRevisions() Check if revision tracking is turned on.
void	removeEnforcement() Removes protection enforcement. In the documentProtection tag inside settings.xml file it sets the value of enforcement to "0" (w:enforcement="0")
void	setEnforcementEditValue(org.openxmlformats.schemas.wordprocessingml.x2006.main.STDocProtect.Enum editValue) Enforces the protection with the option specified by passed editValue. In the documentProtection tag inside settings.xml file it sets the value of enforcement to "1" (w:enforcement="1") and the value of edit to the passed editValue (w:edit="[passed editValue]") sample snippet from settings.xml
void	setEnforcementEditValue(org.openxmlformats.schemas.wordprocessingml.x2006.main.STDocProtect.Enum editValue, java.lang.String password, HashAlgorithm hashAlgo) Enforces the protection with the option specified by passed editValue and password. sample snippet from settings.xml
void	setTrackRevisions(boolean enable) Enable or disable revision tracking.
void	setUpdateFields() Enforces fields update on document open (in Word).
void	setZoomPercent(long zoomPercent) Set zoom. In the zoom tag inside settings.xml file it sets the value of zoom sample snippet from settings.xml
boolean	validateProtectionPassword(java.lang.String password) Validates the existing password

Methods inherited from class org.apache.poi.POIXMLDocumentPart

addRelation, createRelationship, createRelationship, getPackagePart, getPackageRelationship, getParent, getRelationById, getRelationId, getRelations, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

XWPFSettings

public XWPFSettings(PackagePart part,
                    PackageRelationship rel)
             throws java.io.IOException

Throws:

java.io.IOException

XWPFSettings

public XWPFSettings()

Method Detail

getZoomPercent

public long getZoomPercent()

Set zoom.
In the zoom tag inside settings.xml file
it sets the value of zoom
sample snippet from settings.xml

    <w:zoom w:percent="50" />
 

Returns:

percentage as an integer of zoom level

setZoomPercent

public void setZoomPercent(long zoomPercent)

Set zoom.
In the zoom tag inside settings.xml file
it sets the value of zoom
sample snippet from settings.xml

    <w:zoom w:percent="50" /> 
 

isEnforcedWith

public boolean isEnforcedWith(org.openxmlformats.schemas.wordprocessingml.x2006.main.STDocProtect.Enum editValue)

Verifies the documentProtection tag inside settings.xml file
if the protection is enforced (w:enforcement="1")
and if the kind of protection equals to passed (STDocProtect.Enum editValue)

sample snippet from settings.xml

     <w:settings  ... >
         <w:documentProtection w:edit="readOnly" w:enforcement="1"/>
 

Returns:

true if documentProtection is enforced with option readOnly

setEnforcementEditValue

public void setEnforcementEditValue(org.openxmlformats.schemas.wordprocessingml.x2006.main.STDocProtect.Enum editValue)

Enforces the protection with the option specified by passed editValue.

In the documentProtection tag inside settings.xml file
it sets the value of enforcement to "1" (w:enforcement="1")
and the value of edit to the passed editValue (w:edit="[passed editValue]")

sample snippet from settings.xml

     <w:settings  ... >
         <w:documentProtection w:edit="[passed editValue]" w:enforcement="1"/>
 

setEnforcementEditValue

public void setEnforcementEditValue(org.openxmlformats.schemas.wordprocessingml.x2006.main.STDocProtect.Enum editValue,
                                    java.lang.String password,
                                    HashAlgorithm hashAlgo)

Enforces the protection with the option specified by passed editValue and password.

sample snippet from settings.xml

   <w:documentProtection w:edit="[passed editValue]" w:enforcement="1" 
       w:cryptProviderType="rsaAES" w:cryptAlgorithmClass="hash"
       w:cryptAlgorithmType="typeAny" w:cryptAlgorithmSid="14"
       w:cryptSpinCount="100000" w:hash="..." w:salt="...."
   />
 

Parameters:

editValue - the protection type

password - the plaintext password, if null no password will be applied

hashAlgo - the hash algorithm - only md2, m5, sha1, sha256, sha384 and sha512 are supported. if null, it will default default to sha1

validateProtectionPassword

public boolean validateProtectionPassword(java.lang.String password)

Validates the existing password

Parameters:

password -

Returns:

true, only if password was set and equals, false otherwise

removeEnforcement

public void removeEnforcement()

Removes protection enforcement.
In the documentProtection tag inside settings.xml file
it sets the value of enforcement to "0" (w:enforcement="0")

setUpdateFields

public void setUpdateFields()

Enforces fields update on document open (in Word). In the settings.xml file
sets the updateSettings value to true (w:updateSettings w:val="true") NOTICES:

• Causing Word to ask on open: "This document contains fields that may refer to other files. Do you want to update the fields in this document?" (if "Update automatic links at open" is enabled)
• Flag is removed after saving with changes in Word

isTrackRevisions

public boolean isTrackRevisions()

Check if revision tracking is turned on.

Returns:

true if revision tracking is turned on

setTrackRevisions

public void setTrackRevisions(boolean enable)

Enable or disable revision tracking.

Parameters:

enable - true to turn on revision tracking, false to turn off revision tracking