Excerpt |
---|
WordWriter represents a Microsoft Word document as a tree, similar to how Word itself represents a document. Most types of elements used with WordApplication correspond to entities that exist in an actual Word document, with some exceptions. Here is the recursive tree structure that WordWriter uses: |
Code Block |
---|
Document | |--Section | |--Paragraph | | | |--CharacterRun | | | |--InlineImage | | | |--Field (includes Hyperlinks and MergeFields) | | | |--Field Contents | | | |--(Recurses back to Paragraph subtree) | | |--List | | | |--ListEntry | | | |-(Recurses back to Paragraph subtree) | |--Table | |-TableCell | |-(Recurses back to Section subtree) |
The "Recurses back to ..." comments mean that the branch can continue with the same structure of elements as previously defined in the tree. For example, a TableCell can contain a Paragraph, List, and/or another Table, followed by the children those elements support, and so on.
As mentioned previously, not all elements in WordApplication correspond to actual elements in a Word document. For example, the Word file format does not have a list structure. A list item is simply a specialized paragraph with additional formatting. The List type was added to WordApplication to make it easier to work with lists programmatically.
By default, a new Document created using WordApplication.Create() contains the following elements:
Code Block |
---|
Document | |--Section | |--Paragraph | |--CharacterRun |
For more about inserting new elements into a Word document, see Inserting elements using WordApplication.