DOCXCustomizer

About DOCXCustomizer

DOCXCustomizer is a functionality available for Premium licenses only. It includes the public method customizeWordContent, which changes the content styles of new documents and templates on the fly.

DOCXCustomizer supports dozens of styles for all the most common contents of a document: breaks, images, lists, paragraphs, run of texts, sections, paragraph styles, tables, table rows and table cells.

The signature used by this method is the following:

public void customizeWordContent(OptionsDOCXPath referenceNode, OptionsDOCXCustomizer options) throws Exception

The method uses two parameters:

referenceNode: a reference of the content you want to change. It is indicated with a query with the DOCXPath syntaxis.
options: styles to apply.

Examples

The following script creates a DOCX with two paragraphs, and using the customizeWordContent method it changes on the fly the styles of the paragraph that contains the text "Sed tu", adding a background colour, bold text, a new font family and a new font size.

package examples.DOCXCustomizer.customizeWordContent;

import com.javadocx.CreateDocx;
import com.javadocx.elements.*;

public class Sample {
    public static void main(String[] args) throws Exception {
        CreateDocx docx = new CreateDocx();
        
        String text = "Lorem ipsum dolor sit amet, consectetur adipisicing elit.";
        
        OptionsParagraph paragraphOptions = new OptionsParagraph();
        paragraphOptions.setFont("Arial");

        docx.addText(text, paragraphOptions);
        
        text = "Sed ut perspiciatis unde omnis iste natus error sit voluptatem.";
        
        docx.addText(text, paragraphOptions);
        
        OptionsDOCXPath referenceNode = new OptionsDOCXPath();
        referenceNode.setType("paragraph")
                     .setContains("Sed ut");
        
        OptionsDOCXCustomizer options = new OptionsDOCXCustomizer();
        options.setBackgroundColor("FFFF00")
               .setBold(true)
               .setFont("Times New Roman")
               .setFontSize(36);
        
        docx.customizeWordContent(referenceNode, options);
        
        docx.createDocx("output");
    }
}

You can change templates too with customizeWordContent. Let's modify now the level of an item in a list as an example of this:

package examples.DOCXCustomizer.customizeWordContent;

import com.javadocx.CreateDocxFromTemplate;
import com.javadocx.elements.*;

public class Sample {
    public static void main(String[] args) throws Exception {
        CreateDocxFromTemplate docx = new CreateDocxFromTemplate("template.docx");
        
        OptionsDOCXPath referenceNode = new OptionsDOCXPath();
        referenceNode.setType("list")
                     .setOccurrence("-1");
        
        OptionsDOCXCustomizer options = new OptionsDOCXCustomizer();
        options.setBold(true)
               .setColor("0000FF")
               .setDepthLevel(1)
               .setFontSize(12)
               .setType("2");
        
        docx.customizeWordContent(referenceNode, options);

        docx.createDocx("output");
    }
}

Orientation and sizes of a specific section can be altered too:

OptionsDOCXPath referenceNode = new OptionsDOCXPath();
referenceNode.setType("section")
             .setOccurrence("1");

OptionsDOCXCustomizer options = new OptionsDOCXCustomizer();
options.setGutter(10)
       .setHeight(15000)
       .setMarginBottom(3000)
       .setMarginFooter(3000)
       .setMarginHeader(3000)
       .setMarginLeft(3000)
       .setMarginRight(3000)
       .setMarginTop(3000)
       .setNumberCols(3)
       .setOrient("portrait")
       .setWidth(15000);

For more information

Almost all styles of every content existing in a Word document can be customized with the customizeWordContent method, such as paragraph styles, column sizes, borders, colours, aligns, sizes, spacings...

You can check all options available for DOCXCustomizer in its API documentation.