[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

INCLUDETEXT

Syntax:

INCLUDETEXT field-argument-1 [ field-argument-2 ] [ switches ]

field-argument-1:
field-argument

field-argument-2:
field-argument

Description: Inserts all or part of the text and graphics contained in the document named by field-argument-1. If the document is a WordprocessingML document, the portion marked by the optional bookmark field-argument-2 is inserted. If no such bookmark is specified here, the whole document is inserted. If the document is an XML file, the fragment referred to by an XPath expression in the \x switch is inserted. If no such switch is specified, the whole XML file is inserted.

If field-argument-1 contains white space, it shall be enclosed in double quotes. If field-argument-1 contains any backslash characters, each one shall be preceded directly by another backslash character.

Field Value: The specified text and graphics.

Switches: Zero or more of the following field-specific-switches.

\!

Prevents this field from being updated unless all fields in the inserted text are first updated in their original document.

\c field-argument

Specifies that the file specified by field-argument-2 shall be processed by a document filter whose name matches the corresponding field-argument value. Possible field-argument values are implementation-defined.

\n field-argument

The text in this switch's field-argument specifies a namespace mapping for XPath queries. This switch is required if the \x switch refers to an element by name in an XML file that declares a namespace.

\t field-argument

The text in this switch's field-argument specifies an XSLT for formatting XML data.

\x field-argument

The text in this switch's field-argument specifies the XPath for returning a fragment of data in an XML file.

 

[Example: The following field inserts the portion of the WordprocessingML document referred to by the bookmark Summary:

INCLUDETEXT "C:\\Winword\\Port Development RFP" Summary

The following field inserts the Name element of the XML document Resume.xml and applies the XSLT Display.xsl to it:

INCLUDETEXT "C:\\Resume.xml" \n xmlns:a=\"resume-schema\"
\t "C:\\display.xsl" \x a:Resume/a:Name

end example]