OOo contains numerous document options; these are available in the Tools Options dialog. For example, Text Document contains a Print tab, which allows graphics to be printed, or not. The typical method for modifying properties in a document involves using either "get" and "set" methods , or directly accessing object properties. To access advanced document settings, however, you must use a completely different method. First the document has to create an object that supports the document settings. Every document type, except for the Math type, has the ability to create a service using the createlnstance() method. Table 20 contains a list of the properties common to all of the document setting types.
Property | Description |
---|---|
ForbiddenCharacters | Allow access to otherwise forbidden characters . |
LinkUpdateMode | The update mode for links when loading text documents. |
PrinterName | Printer used by the document. |
PrinterSetup | Platform- and driver-dependent printer setup data. |
IsKernAsianPunctuation | Is kerning applied to Asian punctuation? |
CharacterCompressionType | Compression (character spacing) used for Asian characters. |
ApplyUserData | Should user -specific settings saved in a document be loaded again? |
SaveVersionOnClose | Is a new version created when a modified document is closed? |
UpdateFromTemplate | Should a document be updated when its creation template changes? |
FieldAutoUpdate | Are text document fields automatically updated? |
Current DatabaseDataSource | Name of the data source from which the current data is taken. |
Current DatabaseCommand | Displayed object's name (or the SQL statement used). |
Current Data baseCommandType | Specifies how to interpret the DataTableName property. |
DefaultTabStop | Default tab width. |
IsPrintBooklet | Is the document printed as a booklet (brochure)? |
IsPrintBookletFront | If True, only the front pages of a booklet are printed. |
IsPrintBookletBack | If True, only the back pages of a booklet are printed. |
PrintQuality | Quality to use when printing. |
ColorTableURL | URL of the color table (SOC file) showing a palette in dialogs that use colors. |
PrinterIndependentLayout | If true, do not use printer metrics for layout. |
Specific document settings services exist for Writer, Calc, Draw, and Impress documents (see Table 21 ). Although each of these services implements the Settings service as shown in Table 20, all of the properties except for PrinterName and PrinterSetup are optional.
Document Settings Service | Document Type |
---|---|
com.sun.star.text.DocumentSettings | Writer |
com.sun.star.sheet.DocumentSettings | Calc |
com.sun.star.drawing. DocumentSettings | Draw |
com.sun.star.presentation.DocumentSettings | Impress |
As shown in Listing 34 and Figure 14, the Writer document settings support the PrintSettings service (see Table 22 ). The Draw and Impress document settings services each contain special settings that apply only to their respective document types.
Property | Description |
---|---|
PrintGraphics | If True, print graphic object. |
PrintTables | If True, print text tables. |
PrintDrawings | If True, print shapes . |
PrintLeftPages | If True, print left pages. |
PrintRightPages | If True, print right pages. |
PrintControls | If True, print control contained in the document. |
PrintReversed | If True, print the pages in reverse order, starting with the last page. |
PrintPaperFromSetup | If True, use the paper tray specified for the system printer. If False, use the paper tray specified by the page style. |
PrintFaxName | Name of the fax. |
PrintAnnotationMode | Specify how notes are printed. Uses com.sun.star.text.NotePrintMode enumerated value. Possible values include NOT, ONLY, DOC_END, or PAGE_END. |
PrintProspect | If True, prospect printing is used; however, I cannot find a definition for prospect printing. |
PrintPageBackground | If True, the background color and/or background graphic is printed. |
PrintBlackFonts | If True, characters are always printed in black. |