MFC dll封装对话框资源

semo_zhang 2013-04-12

展开全文

最近在做项目的时候，想做一个地图浏览模块，个人想法是把这个模块封装在MFC DLL中工在BCB上的调用。却不想，在封装的过程中遇到了很多的问题。

结果多次调试发现了，MFC DLL中在创建对话框时，无法创建正确的对话框，对话框句柄为NULL。经过确认对话框中的资源ID是正确存在的，无法理解这种

现象的发生。这样在经过几次测试，我在外部调用模块中建立了一个相同ID的资源窗口，再进行测试，发现了一个重要的现象，此时程序能正常的运行了，跟踪DLL

中创建的窗口句柄不在为NULL，窃喜中。。。。。。。

经过比对发现显示的窗口为调用模块的窗口，此时陷入了困惑中......。DLL中的创建窗口无法调用DLL中的资源？

经过查找资料发现，上面所出现的现象是有理可据的。

下面是知识点的总结：

2、动态链接到MFC的DLL

       在讨论关于动态链接到MFC的DLL的模块状态问题之前,先来看一个例子.本例可以通过如下步骤来完成:

1)在VC菜单中File->New新建一个命名为DLLShared的MFC AppWizard的工程,下一步选择Regular DLL using shared MFC DLL.

2)在工程中添加一个对话框资源,其ID为:IDD_ABOUTBOX.并在resource.h之中将IDD_ABOUTBOX 的数值改为100.

3)在DLLShared.cpp中定义如下函数:

void ShowDlg()

{

       CDialog dlg(IDD_ABOUTBOX);

       dlg.DoModal();

}

4)在DLLShared.def文件中的EXPORTS语句中添加一行:ShowDlg,以导出ShowDlg函数.

5)编译生成DLLShared.dll和DLLShared.lib.

继续使用上面的Use工程,将前面生成的DLLShared.dll和DLLShared.lib两个文件复制到工程的Debug目录内,并将

extern "C" __declspec(dllexport) void ShowDlg();

#pragma comment(lib,"debug/DLLStatic")

这两行改为:

void ShowDlg();

#pragma comment(lib,"debug/DLLShared")

编译并运行Use.exe.点击按钮,这次你看到了什么?对,没错,这次弹出的是Use.exe的关于对话框.将上述例子的DLL类型换成MFC Extension DLL(using shared MFC DLL)也会出现相同的问题.

为什么会出现上面的问题?这是因为在使用了MFC共享库的时候,默认情况下,MFC使用主应用程序的资源句柄来加载资源模板.虽然我们调用的是DLL中的函数来显示DLL中的对话框,并且对应的对话框模板是存储在DLL中的,但MFC仍旧在主应用程序也就是Use.exe中寻找相应的对话框模板.由于在DLL中所定义的对话框资源ID与主应用程序中所定义的关于对话框的资源ID相同,所以MFC就把主应用程序中的关于对话框显示了出来.如果二者不同,则MFC就认为DLL中所定义的对话框资源不存在,dlg.DoModal会返回0,也就是什么都不会显示.

那么如何解决上述问题呢?解决办法就是在适当的时候进行模块状态切换,以保证具有当前状态的模块是我们所需要的模块从而使用正确的资源.MFC提供了下列函数和宏来完成这些工作:

AfxGetStaticModuleState:这是一个函数,其函数原型为:

AFX_MODULE_STATE* AFXAPI AfxGetStaticModuleState( );

此函数在堆栈上构造AFX_MODULE_STATE类的实例pModuleState并对其赋值后将其返回.在AFX_MODULE_STATE类的构造函数中,该类获取指向当前模块状态的指针并将其存储在成员变量中,然后将pModuleState设置为新的有效模块状态.在它的析构函数中,该类将存储在其成员变量中的指针还原为存贮的前一个模块状态.

AFX_MANAGE_STATE:这是一个宏,其原型为:

AFX_MANAGE_STATE( AFX_MODULE_STATE* pModuleState )

该宏用于将pModuleState(指向包含模块全局数据也就是模块状态的AFX_MODULE_STATE结构的指针)设置为当前的即时作用空间中(the remainder of the immediate containing scope)的有效模块状态.在离开包含该宏的作用空间时,前一个有效的模块状态自动还原.

AfxGetResourceHandle:这个函数的原型为:

       HINSTANCE AfxGetResourceHandle( );

       该函数返回了一个保存了HINSTANCE类型的、应用程序默认所加载资源的模块的句柄.

AfxSetResourceHandle:这个函数的原型为:

void AfxSetResourceHandle( HINSTANCE hInstResource );
该函数将hInstResource所代表的模块设置为具有当前状态的模块.
通过使用上述四个函数或宏就可以正确的在动态链接到MFC的DLL中切换模块状态.接下来我们将通过修改上面出现问题的那个例子来介绍如何使用上述四个函数或宏.先来看看Regular DLL using shared MFC DLL类型:
在上述例子的第三步的ShowDlg函数的第一条语句前加上如下语句(要确保该语句在函数实现的第一行):
AFX_MANAGE_STATE(AfxGetStaticModuleState());
之后重新编译生成DLLShared.dll和DLLShared.lib,并将这两个文件重新拷贝到Use工程的Debug目录内.这次编译生成Use.exe并运行,点击按钮,可以看到弹出的时我们在DLL中所加入的那个对话框,而不再是Use.exe的关于对话框了.
通过上面的讲解,相信你已经知道该语句的作用了.在函数ShowDlg的第一行加上这么一句后,每次调用DLL的应用程序使用该函数的时候,MFC库都会自动切换当前模块状态,这样就保证了资源读取的正确性.

AFX_MANAGE_STATE(AfxGetStaticModuleState());是自动切换当前模块状态,也可以通过使用AfxGetResourceHandle和AfxSetResourceHandle来手动切换当前模块状态.具体使用方法如下:
在上述例子的第三步的ShowDlg函数的第一条语句前加上如下语句(要确保该语句在函数实现的第一行):
HINSTANCE save_hInstance = AfxGetResourceHandle();

       AfxSetResourceHandle(theApp.m_hInstance);
在调用对话框成功之后,也就是dlg.DoModal();之后,添加:
AfxSetResourceHandle(save_hInstance);
       这种方法在进入ShowDlg函数之后,通过AfxGetResourceHandle来获得并保存当前状态模块的句柄.然后获得DLL模块的句柄theApp.m_hInstance(当然,也可以使用GetModuleHandle函数来获得DLL模块的句柄),并使用AfxSetResourceHandle函数来将其设置为当前状态状态.最后在调用对话框成功之后再用恢复AfxSetResourceHandle资源句柄,将当前模块状态恢复.

       这样做有些麻烦,但是有一点好处是可以在完成使用资源的任务之后就可以立即恢复资源句柄.而AFX_MANAGE_STATE(AfxGetStaticModuleState());的方法只能等函数的作用空间结束之后才恢复资源句柄.由于可执行文件必须重画工具条等原因,因此建议只要有可能就必须恢复资源句柄,否则可能会遇到许多问题.比如说,如果用户移动DLL的对话框,而此时资源句柄仍然为DLL的资源,那么程序就会崩溃.最好的恢复句柄的时机在对话框响应WM_INITDIALOG消息的时候,因为这时对话框的模板等已经读出了.
       对于MFC Extension DLL(using shared MFC DLL)类型的MFC DLL,切换当前模块状态的方法与Regular DLL using shared MFC DLL类型的MFC DLL所使用的方法很相似,这里不再举例实现.二者不同的地方如下:
       在MFC扩展DLL中使用AFX_MANAGE_STATE(AfxGetStaticModuleState());时,会产生如下错误:

mfcs42d.lib(dllmodul.obj) : error LNK2005: __pRawDllMain already defined in dllextend.obj

mfcs42d.lib(dllmodul.obj) : error LNK2005: _DllMain@12 already defined in dllextend.obj

mfcs42d.lib(dllmodul.obj) : error LNK2005: __pRawDllMain already defined in dllextend.obj

因此在MFC扩展DLL中需要将AFX_MANAGE_STATE(AfxGetStaticModuleState());换成AFX_MANAGE_STATE(AfxGetAppModuleState());才能正确切换当前模块状态.

在MFC扩展DLL中使用AfxGetResourceHandle和AfxSetResourceHandle的方法与在Regular DLL using shared MFC DLL类型的MFC DLL中所使用的方法相同.并且,DLL模块的句柄可以通过MFC提供的DlgextentDLL这个结构的hModule成员来获得.即使用AfxSetResourceHandle(DlgextentDLL.hModule);语句.

当然,对于动态链接到MFC的DLL,也可以在调用该DLL的MFC应用程序中使用AfxGetResourceHandle和AfxSetResourceHandle两个函数来切换当前状态模块.该DLL模块的句柄可以用GetModuleHandle函数来获得.在此不再赘述.