insertWordFragment

Option	Type	Description
type	String	* (all, default value), break, chart, endnote (content reference, the whole paragraph is removed), footnote (content reference, the whole paragraph is removed), image, list, paragraph (also for bookmarks, links and lists), section, shape, table.
contains	String	Contains a text string.
occurrence	String	Exact occurrence or range of contents (e.g.: 2..9, 2.., ..9) or first() or last(). If empty iterate all elements.
attributes	HashMap<String, String>	Contains a specific attribute key and value.
parent	String	Main document body as default, allows to set any parent or a specific one. w:body (default), '/' (any parent) or any other specific parent (/w:tbl/, /w:tc/, /w:r/...).
customQuery	String	Custom xpath query, overwrites any other reference.
location	String	after (default) or default.

forceAppend

If true appends the WordFragment if the reference node could not be found (false as default).

Code samples

Example #1

package examples.DOCXPath.insertWordFragment;

import com.javadocx.CreateDocx;
import com.javadocx.WordFragment;
import com.javadocx.elements.OptionsDOCXPath;
import com.javadocx.elements.OptionsParagraph;
import com.javadocx.elements.OptionsText;

public class Sample1 {
    public static void main(String[] args) throws Exception {
        CreateDocx docx = new CreateDocx();
        
        String text = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi utaliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.";

        OptionsParagraph paragraphOptions = new OptionsParagraph();
        paragraphOptions.setBold(true)
                        .setFont("Arial");

        docx.addText(text, paragraphOptions);
        
        docx.addText(text, paragraphOptions);
        
        OptionsText textOptions = new OptionsText();
        textOptions.setText(" New text.")
                   .setFontSize(20)
                   .setColor("#0000ff");
        WordFragment textFragment = new WordFragment(docx);
        textFragment.addText(textOptions); 
        
        OptionsDOCXPath referenceNode = new OptionsDOCXPath();
        referenceNode.setType("paragraph")
                     .setOccurrence("1")
                     .setContains("Lorem")
                     .setLocation("inlineAfter");
        
        docx.insertWordFragment(textFragment, referenceNode);
        
        docx.createDocx("example_insertWordFragment_1");
    }
}

Example #2

package examples.DOCXPath.insertWordFragment;

import java.util.ArrayList;
import java.util.HashMap;

import com.javadocx.CreateDocxFromTemplate;
import com.javadocx.WordFragment;
import com.javadocx.elements.OptionsDOCXPath;
import com.javadocx.elements.OptionsTableData;
import com.javadocx.elements.OptionsTableProperties;

public class Sample2 {
    public static void main(String[] args) throws Exception {
        CreateDocxFromTemplate docx = new CreateDocxFromTemplate("src/examples/files/docxpath/breaks.docx");
        
        WordFragment contentFragment = new WordFragment(docx);
        
        contentFragment.addText("New text");
        
        ArrayList<OptionsTableData> valuesRow1 = new ArrayList<OptionsTableData>();
        
        OptionsTableData valuesRow1Cell1 = new OptionsTableData();
        WordFragment textFragmentRow1Cell1 = new WordFragment(docx);
        textFragmentRow1Cell1.addText("AAA");
        valuesRow1Cell1.setValue(textFragmentRow1Cell1);
        
        OptionsTableData valuesRow1Cell2 = new OptionsTableData();
        WordFragment textFragmentRow1Cell2 = new WordFragment(docx);
        textFragmentRow1Cell2.addText("BBB");
        valuesRow1Cell2.setValue(textFragmentRow1Cell2);
        
        valuesRow1.add(valuesRow1Cell1);
        valuesRow1.add(valuesRow1Cell2);
        
        ArrayList<OptionsTableData> valuesRow2 = new ArrayList<OptionsTableData>();
        
        OptionsTableData valuesRow2Cell1 = new OptionsTableData();
        WordFragment textFragmentRow2Cell1 = new WordFragment(docx);
        textFragmentRow2Cell1.addText("Text");
        valuesRow2Cell1.setValue(textFragmentRow2Cell1);
        
        OptionsTableData valuesRow2Cell2 = new OptionsTableData();
        WordFragment textFragmentRow2Cell2 = new WordFragment(docx);
        textFragmentRow2Cell2.addText("Text: More text");
        valuesRow2Cell2.setValue(textFragmentRow2Cell2);
        
        valuesRow2.add(valuesRow2Cell1);
        valuesRow2.add(valuesRow2Cell2);
        
        ArrayList<ArrayList<OptionsTableData>> valuesTable = new ArrayList<ArrayList<OptionsTableData>>();
        valuesTable.add(valuesRow1);
        valuesTable.add(valuesRow2);
        
        OptionsTableProperties tableProperties = new OptionsTableProperties();
        tableProperties.setBorder("single")
                       .setTableAlign("center")
                       .setBorderWidth(10)
                       .setBorderColor("B70000");
        
        contentFragment.addTable(valuesTable, tableProperties);
        
        HashMap<String, String> attributes = new HashMap<String, String>();
        attributes.put("w:type", "page");
        
        OptionsDOCXPath referenceNode = new OptionsDOCXPath();
        referenceNode.setType("break")
                     .setAttributes(attributes)
                     .setLocation("after");
        
        docx.insertWordFragment(contentFragment, referenceNode);
        
        docx.createDocx("example_insertWordFragment_2");
    }
}