写在前面
之前使用COM接口调用Excel的API时就对该产品的架构产生了浓厚的兴趣,但并COM、ATL、MFC等并不了解,网上也没有太多的资料。
得益于目前的工作,我接触到大量COM相关的知识,并根据网上搜索到的资料,实现了具有此架构的应用程序,在此做一下记录,希望能帮到需要的人。
安装Visual Studio
这部分省略,网上有很多教程,安装时请注意勾选ATL
和MFC
支持。
创建项目
启动VS,创建新项目,项目模板为MFC应用
:
点击创建按钮,应用程序类型选择
基于对话框
,点击完成。
初始化APP
对话框需要由COM接口在初始化时创建,因此,我们需要对CAutoMFCApp
的InitInstance
函数做一些修改:
HRESULT ExeRegisterClassObject(BOOL automationSpecified);
HRESULT ExeUnRegisterClassObject(void);
BOOL CAutoMFCApp::InitInstance()
{
// 如果一个运行在 Windows XP 上的应用程序清单指定要
// 使用 ComCtl32.dll 版本 6 或更高版本来启用可视化方式,
//则需要 InitCommonControlsEx()。 否则,将无法创建窗口。
INITCOMMONCONTROLSEX InitCtrls;
InitCtrls.dwSize = sizeof(InitCtrls);
// 将它设置为包括所有要在应用程序中使用的
// 公共控件类。
InitCtrls.dwICC = ICC_WIN95_CLASSES;
InitCommonControlsEx(&InitCtrls);
CWinApp::InitInstance();
// OLE初始化
if (!AfxOleInit())
{
return FALSE;
}
AfxEnableControlContainer();
// 创建 shell 管理器,以防对话框包含
// 任何 shell 树视图控件或 shell 列表视图控件。
CShellManager *pShellManager = new CShellManager;
// 激活“Windows Native”视觉管理器,以便在 MFC 控件中启用主题
CMFCVisualManager::SetDefaultManager(RUNTIME_CLASS(CMFCVisualManagerWindows));
// 标准初始化
// 如果未使用这些功能并希望减小
// 最终可执行文件的大小,则应移除下列
// 不需要的特定初始化例程
// 更改用于存储设置的注册表项
// TODO: 应适当修改该字符串,
// 例如修改为公司或组织名
SetRegistryKey(_T("应用程序向导生成的本地应用程序"));
CCommandLineInfo cmdInfo;
ParseCommandLine(cmdInfo);
BOOL bAutomationFlag = FALSE;
// 是否以/automation或/embedding模式启动
if (cmdInfo.m_bRunEmbedded || cmdInfo.m_bRunAutomated)
{
bAutomationFlag = TRUE;
}
::ExeRegisterClassObject(bAutomationFlag);
MSG msg = { 0 };
int rVal = 0;
while ((rVal = ::GetMessage(&msg, 0, 0, WM_USER)) != 0) {
if (rVal == -1) {
break;
}
else {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
}
::ExeUnRegisterClassObject();
// 删除上面创建的 shell 管理器。
if (pShellManager != nullptr)
{
delete pShellManager;
}
#if !defined(_AFXDLL) && !defined(_AFX_NO_MFC_CONTROLS_IN_DIALOGS)
ControlBarCleanUp();
#endif
// OLE Terminate
AfxOleTerm(FALSE);
// 由于对话框已关闭,所以将返回 FALSE 以便退出应用程序,
// 而不是启动应用程序的消息泵。
return FALSE;
}
解读
1、调用AfxOleInit
初始化OLE,此后才能使用OLE相关的一系列API,在AfxOleInit
中会调用CoInitalize
。
2、稍后需要实现ExeRegisterClassObject
,在该函数中注册类工厂,此外,如果应用程序不是以自动化模式启动,需要创建IDispatch接口。
3、实现一个消息循环,手动控制在COM接口的引用计数变为0时退出循环。
4、稍后需要实现ExeUnRegisterClassObject
反注册类工厂。
5、最后调用AfxOleTerm
清理线程。
写在后面
本文简单介绍了创建MFC项目的过程,对一些关键点进行了解读,为了实现进程外COM组件,我们还需要完成以下工作:
1、编写IDL接口定义文件,生成类库。
2、将接口添加到注册表。
3、在项目中实现COM接口。
4、在项目中实现工厂类并注册。
下一篇文章,将会编写接口定义文件,并将接口添加到注册表。