Click here to Skip to main content
16,017,726 members
Articles / Programming Languages / C#
Article

Word Control for .NET

Rate me:
Please Sign up or sign in to vote.
4.85/5 (50 votes)
28 Jan 2003GPL33 min read 1.2M   46.6K   193   229
Writing a control to use MS-Word in your own Application like a windows-form.

Sample Image - winwordcontrol.jpg

Introduction

This control allows you to use MS Word 2000 in your own projects such as a windows form. Of course that's a little "dirty trick". But if you have some documentation to display and you want to use Word for it, here is the solution.

Background

I was working on an internal research project and we developed a tool to teach C++, and there was a problem about how to display the exercises. The main problem was, I had difficult formulas in these descriptions so the only possible solution was to convert the files to PDF or to another file format. With PDF I had a problem, because I couldn't edit the documents afterwards. So, I was looking for an ActiveX or .NET control for MS Word. Finally, I couldn't find one. So I decided to write one for .NET.

How to use the control?

It's almost too easy to use the form. You just need to add a link to the winwordcontrol.dll.  The steps are:

  1. Goto your Toolbox.

    Visual Studio Toolbox
     

  2. Click right. Select "Customize Toolbox".

    Toolbox Cutomizing
     

  3. Select the ".NET Components" tab.
  4. Select the winwordcontrol.dll using the file browse dialog. Click OK. After that you will find a new form in your toolbox called "winwordcontrol".

    Toolbox winwordcontrol/winwordcontrol

Drag and drop it just like any other form. The only thing you should know is how to control it. At this moment, there are four methods:

winwordcontrolinstance.LoadDocument(<string path>); 
With LoadDocument you can load all files Word can handle. Please specify the complete path! This is the only method that is probably useful for everyone. All the other methods are not necessary for normal use.
winwordcontrolinstance.CloseControl(); 
This method closes the actual document. This is mostly not necessary because LoadDocument() can handle multiple calls without calling CloseControl() before.
winwordcontrolinstance.PreActivate(); 
Preloading. This method should be used if you don't want to wait in the main program until Word is finished starting.
winwordcontrolinstance.RestoreWord(); 
Reactivates all the Menubars.

The control will automatically start Word if it's not already open and it will display the document.

How does this work?

The basic idea is to instantiate the Word application, as everybody knows, with:

wordInstance = new Word.Application();
Now we have the Word application in a separate window. How do we get this window in our control? The answer is ... Win32 API. We need to import some API functions from user32.dll as shown here:
[DllImport("user32.dll")]
public static extern int FindWindow(string strclassName, string strWindowName);

[DllImport("user32.dll")]
static extern int SetParent(int hWndChild, int hWndNewParent);

[DllImport("user32.dll", EntryPoint = "SetWindowPos")]
static extern bool SetWindowPos(
	int hWnd,               // handle to window
	int hWndInsertAfter,    // placement-order handle
	int X,                  // horizontal position
	int Y,                  // vertical position
	int cx,                 // width
	int cy,                 // height
	uint uFlags             // window-positioning options
);
		
[DllImport("user32.dll", EntryPoint = "MoveWindow")]
static extern bool MoveWindow(
	int hWnd, 
	int X, 
	int Y, 
	int nWidth, 
	int nHeight, 
	bool bRepaint
);
							
const int SWP_DRAWFRAME = 0x20;
const int SWP_NOMOVE = 0x2;
const int SWP_NOSIZE = 0x1;
const int SWP_NOZORDER = 0x4;
This is the most complicated part... because it's NOT documented at all. We need a Pointer to the Word window, so we use FindWindow to find it. What's the name of the window? - "Opusapp" Actually, I don't know what this name means, but it works perfectly.
wordWnd = FindWindow( "Opusapp", null);
So, now we can define our control as a parent to Word:
SetWindowPos(wordWnd, this.Handle.ToInt32(), 0, 0,
	this.Bounds.Width-20, this.Bounds.Height-20,
	SWP_NOZORDER | SWP_NOMOVE | SWP_DRAWFRAME );
Everything else should be pretty easy and it is well documented in the official documentation for the Word namespace.

Points of Interest

You may be interested in my other projects. Please visit my private homepage www.intercompu.de. If you use this stuff or if you use just parts of it, I would appreciate if you mention my name. ;-)

History

  • 23.01.03 First release
  • 25.01.03 Update minor changes (performance enhancement)

License

This article, along with any associated source code and files, is licensed under The GNU General Public License (GPLv3)


Written By
CEO
Germany Germany
I am a developer with a Computer Science degree. I am programming Visual C ++ for over 7 year now and C# for about 3 years. If you want to know more about me please look at my homepage: www.intercompu.de

Comments and Discussions

 
QuestionCan we load another application that is not MS product into this form? Pin
tuine200619-Apr-07 11:09
tuine200619-Apr-07 11:09 
QuestionProblem with opening/Saving a Document PinPopular
Rakesh B Singh23-Feb-07 2:21
Rakesh B Singh23-Feb-07 2:21 
AnswerRe: Problem with opening/Saving a Document [modified] Pin
npkinh17-May-07 23:15
npkinh17-May-07 23:15 
AnswerRe: Problem with opening/Saving a Document Pin
bidalah16-Aug-07 10:30
bidalah16-Aug-07 10:30 
AnswerRe: Problem with opening/Saving a Document Pin
aerradi18-Aug-07 17:14
aerradi18-Aug-07 17:14 
AnswerRe: Problem with opening/Saving a Document Pin
Pritesh Aryan20-Nov-12 18:50
Pritesh Aryan20-Nov-12 18:50 
GeneralError While Processing another word document in running state of this control Pin
sdivya12-Jan-07 14:49
sdivya12-Jan-07 14:49 
GeneralHate to say this.... Pin
Ross Holder6-Dec-06 12:49
Ross Holder6-Dec-06 12:49 
Well I've wasted 2 hours monkeying around with the code sixteen different ways trying to get this thing working with Microsoft Visual Studio .NET 2003 & Office Pro 2003....without any success whatsoever. Cry | :(( The stock "out-of-the-box" code is completely inoperative; although I did manage a bit of handywork myself adding what appeared to be a couple missing references and got MS Word to magically launch itself from the control...but outside of the window I'd hoped to emed the Word interface in.

As is discussed elsewhere here, this might have been marginally useful deploying as a technology with MS Office 2000, but I can't see the utility in it with any subsequent verisons of Word. It certainly doesn't work as advertised, and even if it ever works - it is surely on so narrow an install base you'd have a better chance of being hit by lighting than find yourself with a PC this thing actually compiles and runs on without issue.

Respectfully submitted,


RH (ross.holder[AT]gmail.com)
Ottawa, ON
GeneralRe: Hate to say this.... Pin
bidalah16-Aug-07 10:40
bidalah16-Aug-07 10:40 
GeneralMS Project Pin
jamesrgoodwin6-Dec-06 4:46
jamesrgoodwin6-Dec-06 4:46 
GeneralRun more than one instance Pin
ItsKodali4-Dec-06 19:21
ItsKodali4-Dec-06 19:21 
Questionhow to set readonly property for winwordcontrol Pin
tanthanhduy17-Oct-06 17:43
tanthanhduy17-Oct-06 17:43 
QuestionHow to enable document Pin
tanthanhduy15-Oct-06 17:16
tanthanhduy15-Oct-06 17:16 
AnswerRe: How to enable document Pin
Rakesh B Singh23-Feb-07 2:27
Rakesh B Singh23-Feb-07 2:27 
QuestionFocus and Z order Pin
stealth2415-Oct-06 10:05
stealth2415-Oct-06 10:05 
GeneralREAD ONLY Pin
NikeshM22-Jul-06 23:16
NikeshM22-Jul-06 23:16 
QuestionHow do I open documents? Pin
mkamioner20-Jul-06 12:33
mkamioner20-Jul-06 12:33 
GeneralProblem... Pin
sam_g123-Mar-06 1:06
sam_g123-Mar-06 1:06 
Generali wrote a Excel Control follow your idea then how can i close the excel application Pin
StinJia21-Mar-06 21:59
StinJia21-Mar-06 21:59 
GeneralRe: i wrote a Excel Control follow your idea then how can i close the excel application Pin
sam_g122-Mar-06 0:41
sam_g122-Mar-06 0:41 
GeneralRe: i wrote a Excel Control follow your idea then how can i close the excel application Pin
Michael Cowan3-Sep-07 14:19
Michael Cowan3-Sep-07 14:19 
GeneralRe: i wrote a Excel Control follow your idea then how can i close the excel application Pin
Puzzle Fun20-May-08 7:44
Puzzle Fun20-May-08 7:44 
Questionhow to open the existing PPT file through this control Pin
sam_g121-Mar-06 0:45
sam_g121-Mar-06 0:45 
AnswerRe: how to open the existing PPT file through this control Pin
Member 415515116-Mar-09 0:06
Member 415515116-Mar-09 0:06 
GeneralNo overload for 'OnClose' matches delegate 'Microsoft.Office.Interop.PowerPoint.EApplication_PresentationCloseEventHandler' Pin
sam_g121-Mar-06 0:42
sam_g121-Mar-06 0:42 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.