Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
     Licensed to Plutext Pty Ltd under one or more contributor license agreements.  
   *  This file is part of docx4j.
      docx4j is licensed under the Apache License, Version 2.0 (the "License"); 
      you may not use this file except in compliance with the License. 
      You may obtain a copy of the License at 
     Unless required by applicable law or agreed to in writing, software 
     distributed under the License is distributed on an "AS IS" BASIS, 
     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
     See the License for the specific language governing permissions and 
     limitations under the License.
 package org.docx4j.convert.out;

This interface contains flags that get passed to the conversion process.
  • PP_xx : Functions that get done in the preprocessing step
  • xx_COMMON_xx: Common functions, may be applied to HTML and PDF conversion.
  • xx_HTML_xx: HTML functions, may be applied only to HTML conversion.
  • xx_PDF_xx: PDF functions, may be applied only to PDF conversion.
 public interface ConversionFeatures {

During the conversion the document might be changed. If the caller continues to use the document after it, a deep copy should be done. This is not needed if the document gets discarded after the conversion process.
 	public static final String PP_COMMON_DEEP_COPY = "pp.common.deepcopy";

The conversion is only able to handle bookmarks that are in a paragraph. This flag that bookmarks are in paragraphs. This is not needed if the document doesn't contain bookmarks or page references.
 	public static final String PP_COMMON_MOVE_BOOKMARKS = "pp.common.movebookmarks";

Word might put some pagebreaks in a paragraph. In the conversion process the pagebreaks need to be at the beginning of a paragraph. This is not needed if the document doesn't contain explicit pagebreaks.
 	public static final String PP_COMMON_MOVE_PAGEBREAK = "pp.common.movepagebreak";

Word combines the borders and background colors of two (or more) continuous paragraphs. This flag simulates this behaviour. This is not needed if paragraphs dont have a border or background color defined.
 	public static final String PP_COMMON_CONTAINERIZATION = "pp.common.containerization";

Word may save a field (date, page numbers, references...) in two formats: a simple one and a complex one. The conversion process only knows about the simple ones. This step converts the complex fields (if possible) to simple ones. This step is only required if the document contains page references.
 	public static final String PP_COMMON_COMBINE_FIELDS = "pp.common.combinefields";

The page number formatting might be stored in different places, the section properties and the field definition. If the document contains page count fields (NUMPAGES, SECTIONPAGES) it might be necessary to do a two pass conversion. This step collects the necessary information. A two pass conversion will only be done in PDF. This step isn't necessary if no page numbers are used or no custom formatting has been applied to the page number field and if no page count fields got used.
If this step is omitted then PP_COMMON_DUMMY_PAGE_NUMBERING will be used.
 	public static final String PP_COMMON_PAGE_NUMBERING = "pp.common.pagenumbering";

This step defines some dummy page number information. The required data will be taken only from the section properties. In PDF the conversion will always be one pass. The use of PP_COMMON_PAGE_NUMBERING in HTML doesn't offer any advantage.
 	public static final String PP_COMMON_DUMMY_PAGE_NUMBERING = "pp.common.dummypagenumbering";

In PDF the conversion process needs to break up the document into the defined sections to handle such things as headers and footers. This step does this processing. If the document only contains one section this processing isn't necessary. In the conversion to HTML the document will be treated as if it only has one section, therefore this step isn't needed in HTML.
If this step is omitted then PP_COMMON_DUMMY_CREATE_SECTIONS will be used.
 	public static final String PP_COMMON_CREATE_SECTIONS = "pp.common.createsections";

This step defines only one section for the complete document. The required data will be taken from the body section pointers. In PDF the document will be treated as having only one section. The use of PP_COMMON_CREATE_SECTIONS in HTML doesn't offer any advantage.
 	public static final String PP_COMMON_DUMMY_CREATE_SECTIONS = "pp.common.dummycreatesections";

This step removes a pagebreak before the first paragraph of the document. This is a workaround for You can disable this step if you are using FOP post 1.1 or another FO renderer.
 	public static final String PP_APACHEFOP_DISABLE_PAGEBREAK_FIRST_PARAGRAPH = "pp.apachefop.disablepagebreakfirstparagraph";

Default features, that get applied to a PDF conversion
	public static final String[] DEFAULT_PDF_FEATURES = {

Default features, that get applied to a HTML conversion
	public static final String[] DEFAULT_HTML_FEATURES = {
New to GrepCode? Check out our FAQ X