摘要:本文通过对自动化等COM技术的应用介绍了一种在MFC应用程序中动态嵌入Microsoft Word文档的简单方法。使在MFC应用程序中即可打开、显示和存储外部Word文档。
关键字:VC++、MFC、COM、自动化
引言
Microsoft Office办公套件以其功能强大、方便实用而被广泛使用。其中的Word软件更是作为最流行的文字处理软件而使Word格式文档成为事实上的文件交换标准之一。出于对当前Word格式文档文件流行程度的现实考虑,如果自己开发的字处理软件(或类似功能的软件)不支持Word格式文档那几乎是不可想象的,这样的软件也必然会由于不能处理占相当比例的Word文档文件而不被用户所认同。所以,在此类软件开发时,添加对Word格式文档文件的支持是必不可少的。本文将就此话题展开讨论。
添加类型库到工程
在应用程序中添加对Word支持的方法有很多,但无非以下两大类:一类是自己编写代码或借助第三方提供的程序开发包实现对Word的支持;另一类方法是直接在程序中对Word提供的各种外部功能接口进行调用而同样达到支持Word的目的。前一种方法工作量相对较大,而且无论是在功能上还是在可靠性方面都很难达到与Word一样的水准。后一类方法实际是采取某种技术途径而将支持Word文档的功能转交给Word软件去完成,这样的处理显然能够达到与Word一样的对Word文档文件的支持水平。这一类方法主要借助DDE或COM等技术途径实现,本文将通过COM中的自动化技术借助Word提供的各种外部功能接口实现对Word文档的支持。采用这种方式可以尽可能少的占用自动化客户的资源,并且不需要被访问对象的类型信息就可以进行调用。
下面给出具体实施过程。字处理软件通常采取单文档或多文档程序结构,为了使用Word提供的COM 组件,建立的应用程序需要是包容器,因此在用AppWizard创建一个新的MFC AppWizard(EXE)工程时选择单文档视图(SDI)或多文档视图(MDI)结构,并在第3步选中Container,以提供容器支持。 其它可采取默认选项。在ClassView中将产生如下类:
应用类: CEmbed_WordApp in Embed_Word.h and Embed_Word.cpp
框架类: CMainFrame in MainFrm.h and MainFrm.cpp
文档类: CEmbed_WordDoc in Embed_WordDoc.h and Embed_WordDoc.cpp
视图类: CEmbed_WordView in Embed_WordView.h and Embed_WordView.cpp
容器类: CEmbed_WordCntrItem in CntrItem.h and CntrItem.cpp
接下来添加Word类型库到工程。在View菜单中选择ClassWizard子菜单,从弹出对话框的Automation选项卡中点击Add Class按钮,选择From a TypeLibrary并在Office目录中选中Microsoft Word 97/2000 类型库Word8.olb或Word9.olb,这将把类型库中的所有类添加到你的工程中。这时,ClassView中会多出几十个类,可以通过这些类提供的接口来实现对Word文档的支持。
为了获取标准COM接口IDispach,可在CCntrItem类中添加返回数据类型为LPDISPATCH 的GetIDispatch()函数,该函数通过QueryInterface()方法对IID_Idispatch接口的查询而返回得到指向IDispach接口的指针:
ASSERT_VALID(this); ASSERT(m_lpObject != NULL); LPUNKNOWN lpUnk = m_lpObject; Run(); LPOLELINK lpOleLink = NULL; if(m_lpObject->QueryInterface(IID_IOleLink,(LPVOID FAR*)&lpOleLink)== NOERROR) { ASSERT(lpOleLink != NULL); lpUnk = NULL; if(lpOleLink->GetBoundSource(&lpUnk) != NOERROR) { TRACE0("Warning: Link is not connected!/n"); lpOleLink->Release(); } ASSERT(lpUnk != NULL); } LPDISPATCH lpDispatch = NULL; if(lpUnk->QueryInterface(IID_IDispatch,(LPVOID FAR*)&lpDispatch) != NOERROR) { TRACE0("Waring: does not support IDispatch!/n"); return NULL; } ASSERT(lpDispatch != NULL); return lpDispatch; |
为了使用类型库中的方法,需要在使用类型库的地方添加对“MSWord8.h”的引用(如使用Word 2000,则包含对“MSWord9.h”的引用)。
打开并显示Word文档
在主框架类中添加ID_FILE_OPEN菜单命令响应函数,以便在打开Word文档时能够动态提供对其的支持。下面这段代码在得到Word文档文件的完整路径后,将通过发送WM_COMMAND消息来新建一个文档视图:
// 显示打开文件对话框 CFileDialog fileDlg(TRUE, "*.doc", "*.doc", OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT, "Word文件(*.doc)|*.doc||", NULL); if (fileDlg.DoModal() == IDOK) { // 得到文件路径 m_sPath = fileDlg.GetPathName(); // 新建文档 PostMessage(WM_COMMAND, ID_FILE_NEW, 0); } |
并在视图类的初始化更新函数OnInitialUpdate()中完成Word的动态嵌入:
CMainFrame* pFrame = (CMainFrame*)AfxGetApp()->GetMainWnd(); if (pFrame->m_sPath.Right(3) != "DOC" && pFrame->m_sPath.Right(3) != "doc") return; m_sPath = pFrame->m_sPath; EmbedAutomateWord(); if (m_pSelection != NULL) { CRect rect; GetClientRect(&rect); CDC* pDC = GetDC(); m_pSelection->Draw(pDC,rect); ReleaseDC(pDC); } m_pSelection = NULL; |
其中,EmbedAutomateWord ()函数将负责将Word嵌入到程序。其具体实现过程如下:
BeginWaitCursor(); CEmbed_WordCntrItem* pItem = NULL; TRY { CEmbed_WordDoc* pDoc = GetDocument(); ASSERT_VALID(pDoc); pItem = new CEmbed_WordCntrItem(pDoc); ASSERT_VALID(pItem); CLSID clsid; if (FAILED(::CLSIDFromProgID(L"Word.document", &clsid))) AfxThrowMemoryException(); if (!pItem->CreateFromFile(m_sPath, clsid)) AfxThrowMemoryException(); pItem->DoVerb(OLEIVERB_SHOW, this); m_pSelection = pItem; pDoc->UpdateAllViews(NULL); LPDISPATCH lpDisp; lpDisp = pItem->GetIDispatch(); } CATCH(CException, e) { if (pItem != NULL) { ASSERT_VALID(pItem); pItem->Delete(); } AfxMessageBox(IDP_FAILED_TO_CREATE); } END_CATCH EndWaitCursor(); |
如果仔细研究过这段代码,会发现它同AppWizard自动生成的OnInsertObject()函数有着惊人的相似程度,事实上,上述代码只不过是OnInsertObject()的一个特例:OnInsertObject()允许用户从可用的OLE对象列表中选择其一插入到应用程序中。因为在此我们只需对Word进行自动化,所以派生了这一行为。在这里通过使用CreateFromFile()方法以打开由m_sPath指定的Word文档,并通过DoVerb()方法执行OLEIVERB_SHOW动词来完成文档显示动作。为了使嵌入的工作区占满整个客户区,需要在嵌入文档、客户区大小发生变化以及更新视图后调用Draw()方法进行重新绘制。
保存Word文档
虽然已经将Word环境嵌入到应用程序,Word文档也已经打开并显示,但如果使用向导生成的“保存”功能去保存当前打开的Word文档却只能保存一个空的文档。这是因为当前嵌入Word后的程序界面中的“文件”菜单是属于包容器程序的,在没有和Word建立关联前是无法执行文档保存功能的。在其命令响应函数中添加下述代码以完成对文档的保存:
// 显示打开文件对话框 CFileDialog fileDlg(FALSE, "*.doc", "*.doc", OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT, "Word文件(*.doc)|*.doc||", NULL); if (fileDlg.DoModal() != IDOK) return; CString sPath = fileDlg.GetPathName(); char cPath[256]; memset(cPath, 0, sizeof(cPath)); memcpy(cPath, sPath, sPath.GetLength()); WCHAR wPath[256]; memset(wPath, 0, sizeof(wPath)); MultiByteToWideChar(CP_ACP, MB_COMPOSITE, cPath, sPath.GetLength(), wPath, sizeof(wPath)); IDispatch *pOle = m_pSelection->GetIDispatch(); if (!pOle ) return; // No ole document IPersistFile *pPFile = NULL; pOle->QueryInterface(IID_IPersistFile, (void**)&pPFile); if (!pPFile) { // 不支持IPersistFile接口 if (pOle) pOle->Release(); if (pPFile) pPFile->Release(); } else pPFile->Save(wPath, FALSE); |
这段代码的核心思想是通过使用IPersistFile接口的Save()方法完成对当前文档的保存。由于该方法第一个参数是一个LPOLESTR型变量,查看其宏定义可以知道该变量是一个指向宽字符缓冲区的指针,由CFileDialog类成员函数GetPathName()所返回的CString型文档路径不能直接使用,必须通过MultiByteToWideChar()函数将其内容转换到一个WCHAR型数组中。其第一个参数由CP_ACP指定为使用ANSI编码包,第二个参数设置为MB_COMPOSITE以指出一直使用复合字符。后面四个变量分别为源缓冲区的地址、大小和目的缓冲区的地址和大小。
小结
编译执行程序,当程序打开Word文档时将动态启动Word自动化服务,这时鼠标会处于等待状态,当鼠标恢复正常状态时,Word已经被嵌入到了程序中来,工具条和菜单上增添有许多属于Word的工具条和菜单,可以通过它们对Word文档提供完善的支持和服务。本程序在Windows 2000 Professional 下由Microsoft Visual C++ 6.0编译通过。程序运行需要有Microsoft Word 97 或 Word 2000支持。