pdx:searchAndHighlight Searches for keywords within a Word document and highlights them

pdx:searchAndHighlight

Searches for keywords within a Word document and highlights them.

Description

Element definition

<pdx:utilities>
    <pdx:searchAndHighlight pdx:src="" pdx:target="" pdx:searchTerm="" pdx:highlightColor="">
        <pdx:valueContext pdx:value="" />
        <pdx:valueContext pdx:value="" />
    </pdx:searchAndHighlight>
</pdx:utilities>

​x
 
<pdx:utilities>
    <pdx:searchAndHighlight pdx:src="" pdx:target="" pdx:searchTerm="" pdx:highlightColor="">
        <pdx:valueContext pdx:value="" />
        <pdx:valueContext pdx:value="" />
    </pdx:searchAndHighlight>
</pdx:utilities>
​

This element allows the highlighting of plain text in a DOCX document.

Attributes and sub-elements

src

The path to the source Word document.

target

The path to the Word document resulting after the text highlighting.

searchTerm

The string of text that we want to highlight.

options

The possible keys and values are:

key	Description
highlightColor	the color used for the highlighting: black blue cyan green magenta red yellow white darkBlue darkCyan darkGreen darkMagenta darkRed darkYellow darkGray lightGray none The default value is ‘yellow’.
document	If true highlights the search string in the body of the document. The default value is true.
endnotes	If true highlights the search string in the document endnotes. The default value is false.
comments	If true highlights the search string in the document comments. The default value is false.
headersAndFooters	If true highlights the search string in headers and footers. The default value is true.
footnotes	If true highlights the search string in the document footnotes. The default value is false.

Code samples

#Example 1

config.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:config>
        <pdx:output pdx:name="output" pdx:type="docx" />
    </pdx:config>
</pdx:document>

 
<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:config>
        <pdx:output pdx:name="output" pdx:type="docx" />
    </pdx:config>
</pdx:document>
​

content.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:utilities>
        <pdx:searchAndHighlight pdx:source="/var/www/xmldocx/samples/files/second.docx" pdx:target="/var/www/xmldocx/samples/DocxUtilities/searchAndHighlight/output_searchAndHighlight.docx" pdx:searchTerm="data" pdx:highlightColor="green">
            <pdx:valueContext pdx:value="document" />
            <pdx:valueContext pdx:value="endnotes" />
            <pdx:valueContext pdx:value="comments" />
            <pdx:valueContext pdx:value="headersAndFooters" />
            <pdx:valueContext pdx:value="footnotes" />
        </pdx:searchAndHighlight>
    </pdx:utilities>
</pdx:document>

 
<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:utilities>
        <pdx:searchAndHighlight pdx:source="/var/www/xmldocx/samples/files/second.docx" pdx:target="/var/www/xmldocx/samples/DocxUtilities/searchAndHighlight/output_searchAndHighlight.docx" pdx:searchTerm="data" pdx:highlightColor="green">
            <pdx:valueContext pdx:value="document" />
            <pdx:valueContext pdx:value="endnotes" />
            <pdx:valueContext pdx:value="comments" />
            <pdx:valueContext pdx:value="headersAndFooters" />
            <pdx:valueContext pdx:value="footnotes" />
        </pdx:searchAndHighlight>
    </pdx:utilities>
</pdx:document>
​

settings.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:settings>
    </pdx:settings>
</pdx:document>

 
<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:settings>
    </pdx:settings>
</pdx:document>
​

import os as os
import sys as sys
sys.path.append(os.path.abspath("wrappers/python/XmlDocx"))
import XmlDocx as XmlDocx
document = XmlDocx.XmlDocx("config.xml")
document.setDocumentProperties("settings.xml")
document.addContent("content.xml")
document.setXmlDocxPath("xmldocx path")
document.render()

 
import os as os
import sys as sys
sys.path.append(os.path.abspath("wrappers/python/XmlDocx"))
import XmlDocx as XmlDocx
document = XmlDocx.XmlDocx("config.xml")
document.setDocumentProperties("settings.xml")
document.addContent("content.xml")
document.setXmlDocxPath("xmldocx path")
document.render()
​

var XmlDocx = require("wrappers/XmlDocx.js");

var document = new XmlDocx("config.xml");
document.setDocumentProperties("settings.xml");
document.addContent("content.xml");
document.setXmldocxPath("xmldocx path");
document.render();

 
var XmlDocx = require("wrappers/XmlDocx.js");
​
var document = new XmlDocx("config.xml");
document.setDocumentProperties("settings.xml");
document.addContent("content.xml");
document.setXmldocxPath("xmldocx path");
document.render();
​

using System;
using XmlDocx;

namespace XmldocxSample
{
    public class Xmldocxtest
    {
        static void Main(string[] args)
        {
            Xmldocx docx = new Xmldocx('config.xml');
            docx.setDocumentProperties('settings.xml');
            docx.addContent('content.xml');
            docx.render();
        }
    }
}

 
using System;
using XmlDocx;
​
namespace XmldocxSample
{
    public class Xmldocxtest
    {
        static void Main(string[] args)
        {
            Xmldocx docx = new Xmldocx('config.xml');
            docx.setDocumentProperties('settings.xml');
            docx.addContent('content.xml');
            docx.render();
        }
    }
}
​

import com.Xmldocx;

public class Xmldocxtest
{
    public static void main(final String[] args) {
          
        XmlDocx docx = new XmlDocx('config.xml');
        docx.setDocumentProperties('settings.xml');
        docx.addContent('content.xml');
        docx.setXmldocxPath('xmldocx path');
        docx.render();
    }
}

 
import com.Xmldocx;
​
public class Xmldocxtest
{
    public static void main(final String[] args) {
          
        XmlDocx docx = new XmlDocx('config.xml');
        docx.setDocumentProperties('settings.xml');
        docx.addContent('content.xml');
        docx.setXmldocxPath('xmldocx path');
        docx.render();
    }
}
​

require "wrappers/XmlDocx.rb"

document = XmlDocx.new("config.xml")
document.setDocumentProperties("settings.xml")
document.addContent("content.xml")
document.setXmlDocxPath("xmldocx path")
document.render

 
require "wrappers/XmlDocx.rb"
​
document = XmlDocx.new("config.xml")
document.setDocumentProperties("settings.xml")
document.addContent("content.xml")
document.setXmlDocxPath("xmldocx path")
document.render
​

#include "XmlDocx.h"

XmlDocxType doc;

char *config = "config.xml";
char *properties = "settings.xml";
char *content = "content.xml";

init(doc, "config.xml", 0);
addDocumentProperties(doc, "settings.xml");
addContent(doc, "content.xml");
setXmldocxPath(docx, "xmldocx path");
render(doc);

 
#include "XmlDocx.h"
​
XmlDocxType doc;
​
char *config = "config.xml";
char *properties = "settings.xml";
char *content = "content.xml";
​
init(doc, "config.xml", 0);
addDocumentProperties(doc, "settings.xml");
addContent(doc, "content.xml");
setXmldocxPath(docx, "xmldocx path");
render(doc);
​

The resulting Word document looks like: