com.lowagie.text.rtf.document

Class RtfDocumentSettings

public class RtfDocumentSettings extends Object

The RtfDocumentSettings contains output specific settings. These settings modify how the actual document is then generated and some settings may mean that some RTF readers can't read the document or render it wrongly.

Version: $Id: RtfDocumentSettings.java 3440 2008-05-25 18:16:48Z howard_s $

Author: Mark Hall (Mark.Hall@mail.room3b.eu) Thomas Bickel (tmb99@inode.at) Howard Shank (hgshank@yahoo.com)

Field Summary
boolean	alwaysGenerateSoftLinebreaks Whether to always generate soft linebreaks for \n in Chunks.
boolean	alwaysUseUnicode Whether to always translate characters past 'z' into unicode representations.
int	dataCacheStyle How to cache the document during generation.
RtfDocument	document The RtfDocument this RtfDocumentSettings belongs to.
boolean	imagePDFConformance Whether images should be written in order to mimick the PDF output.
boolean	imageWrittenAsBinary Images are written as binary data and not hex encoded.
boolean	outputDebugLineBreaks Whether to output the line breaks that make the rtf document source more readable.
boolean	outputTableRowDefinitionAfter Whether to also output the table row definition after the cell content.
String	protectionHash Document protection level password hash.
int	protectionLevel Document protection level.
boolean	readOnlyRecommended Document recommended to be opened in read only mode.
boolean	writeImageScalingInformation Whether to write image scaling information.
String	writereservhash Document read password hash.

Constructor Summary
	RtfDocumentSettings(RtfDocument document) Constructs a new RtfDocumentSettings object.

Method Summary
int	convertProtectionLevel() Converts protection level from internal bitmap value to protlevel output value.
int	getDataCacheStyle() Gets the current data cache style.
byte[]	getProtectionHashBytes() Obtain the password has as a byte array.
int	getProtectionLevel() Author: Howard Shank (hgshank@yahoo.com)
byte[]	getProtectionLevelBytes() Author: Howard Shank (hgshank@yahoo.com)
int	getProtectionLevelRaw() Author: Howard Shank (hgshank@yahoo.com)
boolean	getReadOnlyRecommended() Get the RTF flag that recommends if the the document should be opened in read only mode.
boolean	isAlwaysGenerateSoftLinebreaks() Gets whether all linebreaks inside Chunks are generated as soft linebreaks.
boolean	isAlwaysUseUnicode() Gets whether all characters bigger than 'z' are represented as unicode.
boolean	isDocumentProtected() Determine if document has protection enabled.
boolean	isImagePDFConformance() Gets the current setting on image PDF conformance.
boolean	isImageWrittenAsBinary() Gets whether images are written as binary data or are hex encoded.
boolean	isOutputDebugLineBreaks() Gets whether to output the line breaks for increased rtf document readability.
boolean	isOutputTableRowDefinitionAfter() Gets whether the table row definition should also be written after the cell content.
boolean	isWriteImageScalingInformation() Gets whether to write scaling information for images.
void	registerParagraphStyle(RtfParagraphStyle rtfParagraphStyle) Registers the RtfParagraphStyle for further use in the document.
void	setAlwaysGenerateSoftLinebreaks(boolean alwaysGenerateSoftLinebreaks) Sets whether to always generate soft linebreaks.
void	setAlwaysUseUnicode(boolean alwaysUseUnicode) Sets whether to represent all characters bigger than 'z' as unicode.
void	setDataCacheStyle(int dataCacheStyle) Sets the data cache style.
void	setImagePDFConformance(boolean imagePDFConformance) Sets the image PDF conformance setting.
void	setImageWrittenAsBinary(boolean imageWrittenAsBinary) Set whether images are written as binary data or are hex encoded.
boolean	setNewPassword(String oldPwd, String newPwd) Author: Howard Shank (hgshank@yahoo.com)
void	setOptionsForMSWord2000And97() Set the options required for RTF documents to display correctly in MS Word 2000 and MS Word 97.
void	setOptionsForMSWordForMac() Set the options required for RTF documents to display correctly in MS Word for Mac.
void	setOptionsForMSWordXP() Set the options required for RTF documents to display correctly in MS Word XP (2002).
void	setOptionsForOpenOfficeOrg() Set the options required for RTF documents to display correctly in OpenOffice.Org Writer.
void	setOutputDebugLineBreaks(boolean outputDebugLineBreaks) Sets whether to output the line breaks for increased rtf document readability.
void	setOutputTableRowDefinitionAfter(boolean outputTableRowDefinitionAfter) Sets whether the table row definition should also be written after the cell content.
void	setPasswordHash(String pwd) This function is not intended for general use.
boolean	setProtection(int level, String pwd) Author: Howard Shank (hgshank@yahoo.com)
boolean	setProtectionLevel(int level) Author: Howard Shank (hgshank@yahoo.com)
void	setReadOnlyRecommended(boolean value) Set the RTF flag that recommends the document be opened in read only mode.
void	setWriteImageScalingInformation(boolean writeImageScalingInformation) Sets whether image scaling information should be written.
boolean	unprotectDocument(String pwd) Author: Howard Shank (hgshank@yahoo.com)

Field Detail

alwaysGenerateSoftLinebreaks

private boolean alwaysGenerateSoftLinebreaks

Whether to always generate soft linebreaks for \n in Chunks.

alwaysUseUnicode

private boolean alwaysUseUnicode

Whether to always translate characters past 'z' into unicode representations.

dataCacheStyle

private int dataCacheStyle

How to cache the document during generation. Defaults to RtfDataCache.CACHE_MEMORY;

document

private RtfDocument document

The RtfDocument this RtfDocumentSettings belongs to.

imagePDFConformance

private boolean imagePDFConformance

Whether images should be written in order to mimick the PDF output.

imageWrittenAsBinary

private boolean imageWrittenAsBinary

Images are written as binary data and not hex encoded. Author: Mark Hall (Mark.Hall@mail.room3b.eu)

Since: 2.1.1

outputDebugLineBreaks

private boolean outputDebugLineBreaks

Whether to output the line breaks that make the rtf document source more readable.

outputTableRowDefinitionAfter

private boolean outputTableRowDefinitionAfter

Whether to also output the table row definition after the cell content.

protectionHash

private String protectionHash

Document protection level password hash. Author: Howard Shank (hgshank@yahoo.com)

Since: 2.1.1

protectionLevel

private int protectionLevel

Document protection level. Author: Howard Shank (hgshank@yahoo.com)

Since: 2.1.1

readOnlyRecommended

private boolean readOnlyRecommended

Document recommended to be opened in read only mode. Author: Howard Shank (hgshank@yahoo.com)

Since: 2.1.1

writeImageScalingInformation

private boolean writeImageScalingInformation

Whether to write image scaling information. This is required for Word 2000, 97 and Word for Mac

writereservhash

private String writereservhash

Document read password hash. Author: Howard Shank (hgshank@yahoo.com)

Since: 2.1.1

Constructor Detail

RtfDocumentSettings

public RtfDocumentSettings(RtfDocument document)

Constructs a new RtfDocumentSettings object.

Parameters: document The RtfDocument this RtfDocumentSettings belong to.

Method Detail

convertProtectionLevel

private int convertProtectionLevel()

Converts protection level from internal bitmap value to protlevel output value. Author: Howard Shank (hgshank@yahoo.com)

Returns:

 0 = Revision protection
 1 = Annotation/Comment protection
 2 = Form protection
 3 = Read only protection

Since: 2.1.1

getDataCacheStyle

public int getDataCacheStyle()

Gets the current data cache style.

Returns: The current data cache style.

getProtectionHashBytes

public byte[] getProtectionHashBytes()

Obtain the password has as a byte array. Author: Howard Shank (hgshank@yahoo.com)

Returns: The bytes of the password hash as a byte array (byte[])

Since: 2.1.1

getProtectionLevel

public int getProtectionLevel()

Author: Howard Shank (hgshank@yahoo.com)

Returns: RTF document protection level

Since: 2.1.1

getProtectionLevelBytes

public byte[] getProtectionLevelBytes()

Author: Howard Shank (hgshank@yahoo.com)

Returns: RTF document protection level as a byte array (byte[])

Since: 2.1.1

getProtectionLevelRaw

public int getProtectionLevelRaw()

Author: Howard Shank (hgshank@yahoo.com)

Returns: RTF document protection level

Since: 2.1.1

getReadOnlyRecommended

public boolean getReadOnlyRecommended()

Get the RTF flag that recommends if the the document should be opened in read only mode. Author: Howard Shank (hgshank@yahoo.com)

Returns: true if flag is set, false if it is not set

Since: 2.1.1

isAlwaysGenerateSoftLinebreaks

public boolean isAlwaysGenerateSoftLinebreaks()

Gets whether all linebreaks inside Chunks are generated as soft linebreaks.

Returns: True if soft linebreaks are generated, false for hard linebreaks.

isAlwaysUseUnicode

public boolean isAlwaysUseUnicode()

Gets whether all characters bigger than 'z' are represented as unicode.

Returns: True if unicode representation is used, false otherwise.

isDocumentProtected

public boolean isDocumentProtected()

Determine if document has protection enabled. Author: Howard Shank (hgshank@yahoo.com)

Returns: true if protection is enabled, false if it is not enabled

Since: 2.1.1

isImagePDFConformance

public boolean isImagePDFConformance()

Gets the current setting on image PDF conformance.

Returns: The current image PDF conformance.

isImageWrittenAsBinary

public boolean isImageWrittenAsBinary()

Gets whether images are written as binary data or are hex encoded. Defaults to true. Author: Mark Hall (Mark.Hall@mail.room3b.eu)

Returns: True if images are written as binary data, false if hex encoded.

Since: 2.1.1

isOutputDebugLineBreaks

public boolean isOutputDebugLineBreaks()

Gets whether to output the line breaks for increased rtf document readability.

Returns: Whether to output line breaks.

isOutputTableRowDefinitionAfter

public boolean isOutputTableRowDefinitionAfter()

Gets whether the table row definition should also be written after the cell content.

Returns: Returns the outputTableRowDefinitionAfter.

isWriteImageScalingInformation

public boolean isWriteImageScalingInformation()

Gets whether to write scaling information for images.

Returns: Whether to write scaling information for images.

registerParagraphStyle

public void registerParagraphStyle(RtfParagraphStyle rtfParagraphStyle)

Registers the RtfParagraphStyle for further use in the document. This does not need to be done for the default styles in the RtfParagraphStyle object. Those are added automatically.

Parameters: rtfParagraphStyle The RtfParagraphStyle to register.

setAlwaysGenerateSoftLinebreaks

public void setAlwaysGenerateSoftLinebreaks(boolean alwaysGenerateSoftLinebreaks)

Sets whether to always generate soft linebreaks.

Parameters: alwaysGenerateSoftLinebreaks Whether to always generate soft linebreaks.

setAlwaysUseUnicode

public void setAlwaysUseUnicode(boolean alwaysUseUnicode)

Sets whether to represent all characters bigger than 'z' as unicode.

Parameters: alwaysUseUnicode True to use unicode representation, false otherwise.

setDataCacheStyle

public void setDataCacheStyle(int dataCacheStyle)

Sets the data cache style. This controls where the document is cached during generation. Two cache styles are supported:

RtfDataCache.CACHE_MEMORY: The document is cached in memory. This is fast, but places a limit on how big the document can get before causing OutOfMemoryExceptions.
RtfDataCache.CACHE_DISK: The document is cached on disk. This is slower than the CACHE_MEMORY setting, but the document size is now only constrained by the amount of free disk space.

Parameters: dataCacheStyle The data cache style to set. Valid constants can be found in RtfDataCache.

setImagePDFConformance

public void setImagePDFConformance(boolean imagePDFConformance)

Sets the image PDF conformance setting. By default images will be added as if they were displayed with 72dpi. Set this to false if images should be generated with the Word default DPI setting.

Parameters: imagePDFConformance True if PDF equivalence is desired, false for the default Word display.

setImageWrittenAsBinary

public void setImageWrittenAsBinary(boolean imageWrittenAsBinary)

Set whether images are written as binary data or are hex encoded. Author: Mark Hall (Mark.Hall@mail.room3b.eu)

Parameters: imageWrittenAsBinary True to write images as binary data, false for hex encoding.

Since: 2.1.1

setNewPassword

public boolean setNewPassword(String oldPwd, String newPwd)

Author: Howard Shank (hgshank@yahoo.com)

Parameters: oldPwd Old password - clear text newPwd New password - clear text

Returns: true if password set, false if password not set

Since: 2.1.1

setOptionsForMSWord2000And97

public void setOptionsForMSWord2000And97()

Set the options required for RTF documents to display correctly in MS Word 2000 and MS Word 97. Sets outputTableRowDefinitionAfter = true and writeImageScalingInformation = true.

setOptionsForMSWordForMac

public void setOptionsForMSWordForMac()

Set the options required for RTF documents to display correctly in MS Word for Mac. Sets writeImageScalingInformation = true.

setOptionsForMSWordXP

public void setOptionsForMSWordXP()

Set the options required for RTF documents to display correctly in MS Word XP (2002). Sets writeImageScalingInformation = false.

setOptionsForOpenOfficeOrg

public void setOptionsForOpenOfficeOrg()

Set the options required for RTF documents to display correctly in OpenOffice.Org Writer. Sets outputTableRowDefinitionAfter = false.

setOutputDebugLineBreaks

public void setOutputDebugLineBreaks(boolean outputDebugLineBreaks)

Sets whether to output the line breaks for increased rtf document readability. Some line breaks may be added where the rtf specification demands it.

Parameters: outputDebugLineBreaks The outputDebugLineBreaks to set.

setOutputTableRowDefinitionAfter

public void setOutputTableRowDefinitionAfter(boolean outputTableRowDefinitionAfter)

Sets whether the table row definition should also be written after the cell content. This is recommended to be set to true if you need Word2000 compatiblity and false if the document should be opened in OpenOffice.org Writer.

Parameters: outputTableRowDefinitionAfter The outputTableRowDefinitionAfter to set.

setPasswordHash

public void setPasswordHash(String pwd)

This function is not intended for general use. Please see 'public boolean setProtection(int level, String pwd)'. Author: Howard Shank (hgshank@yahoo.com)

Parameters: pwd Password HASH to set the document password hash to.

Since: 2.1.1