To illustrate, one such function that has changed is the Microsoft Word 2000 Add method of the Documents object. If you've used the ClassWizard to generate class wrappers for the functions in the Microsoft Word 2000 type library and you use code that worked with Microsoft Word 97, you will receive the compile error previously described. The following describes how you can correct this problem. Note that although the case illustrated applies to code that specifically automates Word, the same information can be applied to the other Microsoft Office applications.
With the Word 97 type library, you could use the following code to automate Word and start a new document:
_Application oApp;
Documents oDocs;
_Document oDoc;
COleVariant vtOptional((long)DISP_E_PARAMNOTFOUND,VT_ERROR),
vtTrue((short)TRUE),
vtFalse((short)FALSE);
// Create an instance of Word
if (!oApp.CreateDispatch("Word.Application"))
{
AfxMessageBox("Word failed to start!");
return;
}
// Add a new document and make Word visible
oDocs = oApp.GetDocuments();
oDoc = oDocs.Add(vtOptional,vtOptional);
oApp.SetVisible(TRUE);
If you attempt to run this code against the Word 2000 type library, you will receive the compile error C2660 "'Add' : function does not take 2 parameters" for the following line of code:
oDoc = oDocs.Add(vtOptional,vtOptional);
To correct this problem, you can perform the following steps.
- Go to the ClassView tab of the Project Workspace window.
- In the Classes list for your workspace, double-click the Documents class to display its members.
- Locate the Add Member function and you will see that it is expecting four arguments. Your code is only passing two arguments, thus you receive the compile error.
- Refer to the Visual Basic Help in Microsoft Word and locate the topic for the Add Method of the Documents object to determine what type of data to use for these arguments and/or to determine if the arguments are optional. In this case, both new arguments are optional.
- Return to your project and modify the offending line of code to read:
oDoc = Docs.Add(vtOptional,vtOptional,vtOptional,vtOptional);
- Recompile the project. It should now compile without the error.
Automating Multiple Versions of Office Applications
If you intend to write MFC code that will automate multiple versions
of a Microsoft Office application, you should use the ClassWizard to generate wrapper classes from the type library of the earliest version. For example, if you would like your Automation client to support both Microsoft Word 97 and 2000, use the Word 97 type library for your wrapper classes. Likewise, if you want your Automation client to support both Microsoft 2000 and 2002, use the Word 2000 type Library for your wrapper classes.