Skip to main content
Email Password   helpLost your password?

Resulting document displayed in Word 2007

Introduction

Word 2007 is becoming quite widespread even before becoming a production release. There have been over 3 million downloads of Beta 2 already as at July 2007. This article demonstartes a system for creating simple Word 2007 documents based solely on the packaging and XML formats. This can run on the desktop or a server and requires no installation of Word.

Background

It is quite common to see articles talking about using Word on a server to create or manipulate Microsoft Word documents. Often these applications are only tested on a developers machine, as they will fail in a production environment, as this usually requires running multiple threads. Only one instance of Word can run at a time, so the app must maintain a queue, and process as Word becomes free. This is especially problematic in a web server environment.

Add to this the fact that many System Administrators will either not install Word on a server, or require an in depth business case to be provided, it is often not as simple as it could be.

Using the code

A Word 2007 document usually has the extension .docx There are exceptions for macro enabled documents, templates etc. For this article we will only look at .docx files. This is actually a group of files and folders zipped up. By opening the file file with a zipping application you will see a structure like this:

Folder structure of a word document

This is a very simple word document, and the structure can get a lot more complex. The text content of the word document is found in the word\document.xml file.

The code will create the package, but takes a very simple approach, creating the word\document.xml file, and adding a standard set of files for all the auxilliary files.

DocumentMaker supports a very limited subset of the Word object model, The only styles supported in this limited version are:

We begin by creating a Document object. This is quite similar to the Document Object model that you might use in a standard Word application.

// The document object represents the word document, without the Word 2007 
// packaging
Document doc = new Document();

Now we can add objects that derive from Paragraph to the Paragraphs collection.

doc.Paragraphs.Add(new Heading1("Document maker"));

A paragraph contains only plain text. If formatted text is required, then a Run object is required, or alternatively, an overloaded version of the Paragraph constructor allows for a formatting style to be specified. A Run represents a contiguous piece of text with one style applied to it. If the text requires mixed styling, i.e. some text with a bold word in the middle of it, then separate Runs can be added to the Paragraph object.

// Add a paragraph that is italic, using an overloaded constructor

doc.Paragraphs.Add(new Paragraph("By Mark Focas, July 2006", 
        TextFormats.Format.Italic));

// Or Create a Paragraph object and add Runs ro it.

Paragraph p=new Paragraph();
p.Runs.Add(new Run("Text can have multiple format styles, they can be "));
p.Runs.Add(new Run("bold and italic", 
        TextFormats.Format.Bold | TextFormats.Format.Italic));
doc.Paragraphs.Add(p);

Note how the Run objects can be or ed together to create combinations

p.Runs.Add(new Run("bold and italic", 
        TextFormats.Format.Bold | TextFormats.Format.Italic));

Once the document has been created, it needs to be packaged to be of any use. For maximum flexibility, DocumentMaker returns a Stream object

// A document is of little use unless pacakged in the Word 2007 
// Packaging format
DocumentPackager dp = new DocumentPackager(); Stream s= dp.Package(doc);

There are not many objects in the solution, most of them have been described above.

Class diagram for DocumentMaker

Points of Interest

The Microsoft XML model for Word appears complex, but in some ways is quite simple. Every object is a paragraph, all headings, list items etc. This makes it extremely simple to generate word documents, but extremely complex to process using XSLT. The approach I took with the Run object is based on the approach the Word XML format takes.

I remain completely neutral about, and do not wish to enter in any debate on whether Word XML is better that Open Document Language or vice versa. This article should not be viewed as claiming Microsoft Word is any better or worse than Open Office. It could easily be adapted to output Open Office format if you require that.

Having said that, I am rather disappointed that Microsoft are intending to charge for downloads of Office 2007 beta 2 from August.

History

30 July 2006 - Version 1.0.0

You must Sign In to use this message board.
 
 
Per page   
 FirstPrevNext
GeneralLicense? Pin
Member 5972325
3:40 2 Mar '09  
GeneralRe: License? Pin
Mark Focas
12:39 2 Mar '09  
GeneralRe: License? Pin
august.rydberg
8:58 7 May '09  
QuestionGreat work on this! One question about Versions of Word Pin
ola halvorsen
0:06 24 Feb '09  
AnswerRe: Great work on this! One question about Versions of Word Pin
Mark Focas
12:33 2 Mar '09  
Generalreally! what about table support ? Pin
pita2000
10:07 3 Feb '09  
GeneralRe: really! what about table support ? Pin
Mark Focas
12:34 2 Mar '09  
Generaltable support? Pin
Unruled Boy
20:39 30 Dec '08  
GeneralWhat to do if I want Times New Roman? Pin
d00_ape
0:10 2 Jan '08  
QuestionAbout vb Pin
akilandam
23:07 28 Nov '07  
GeneralAdded your article reference Pin
PuneDotNet
21:02 28 Oct '07  
GeneralGood Work Pin
Hiran Das
23:55 22 Aug '07  
QuestionHow to insert image? Pin
tushar_vaja
20:04 7 Aug '07  
AnswerRe: How to insert image? Pin
Mark Focas
3:14 8 Aug '07  
GeneralGOOD!! how can I insert a header?? Pin
hemaral
10:01 30 Jul '07  
GeneralRe: GOOD!! how can I insert a header?? Pin
Mark Focas
3:16 8 Aug '07  
GeneralRe: GOOD!! how can I insert a header?? Pin
Mark Focas
20:54 20 Aug '07  
GeneralChange Color or Font Size? Pin
VbGuru613
5:32 22 Aug '06  
GeneralRe: Change Color or Font Size? Pin
Mark Focas
2:44 23 Aug '06  
GeneralRe: Change Color or Font Size? Pin
VbGuru613
6:46 23 Aug '06  
GeneralRe: Change Color or Font Size? Pin
Mark Focas
2:10 28 Aug '06  
GeneralRe: Change Color or Font Size? Pin
VbGuru613
3:13 28 Aug '06  
GeneralRe: Change Color or Font Size? Pin
VbGuru613
4:18 28 Aug '06  
GeneralWell done! Pin
Nader Elshehabi
2:29 11 Aug '06  
GeneralRe: Well done! Pin
Mark Focas
2:11 28 Aug '06  


Last Updated 31 Jul 2006 | Advertise | Privacy | Terms of Use | Copyright © CodeProject, 1999-2009