第一代window程序员使用windows api进行编程,到了后来,微软推出MFC类库,于是,动态链接库进行了升级,可以在动态连接库中使用MFC的API,这就叫做MFC动态链接库,
其中MFC动态链接库又分为两种,MFC规则动态链接库和MFC扩展动态链接库,两者有些不同,一般来说规则动态链接库封装一些函数,方法和自己对MFC方法的封装,而扩展动态链接库
主要用于扩展MFC的控件,比如MFC的CLIST功能单一,就可以扩展成功能强大的表格,甚至可以扩展到像excel的功能.
今天说说MFC规则动态链接库,在VS中选择新建一个MFC DLL项目,就可以选择建立规则DLL还是扩展DLL,规则DLL没有WIN32动态链接库所有的DllMain函数,但是它包含有一个从
CWinApp继承下来的类,theapp在DLL初始化的时候自动调用DllMain,也就是说,类似于MFC编程WinMain函数被封装起来一样,MFC规则动态链接库封装了DllMain.
在调用规则动态链接库的时候,需要注意两个方面,第一是:静态链接的时候,不需要DLL进行模块状态的切换,第二是动态链接的时候,一定不能忘了切换模块.windows程序都有着自己的资源
ID,程序启动的时候,默认系统使用的是主线程的资源ID,程序调用的工具栏,菜单,等等资源,都与这个资源ID相关联,或者叫做资源模板.但是当DLL和调用程序都有着自己的资源模板的时候,主线程
调用DLL显示或者使用某个资源的时候,如果没有切换资源ID,DLL会使用主线程的资源,而不是使用DLL本身的资源,这样就会造成程序的混乱,所以,记住一点,在MFC规则动态链接库中,任何函数的第一行加上
AFX_MANAGE_STATE(AfxGetStaticModuleState());
该函数类似于单片机的中断压栈指令,他会将原先的资源模板替换成现在正在使用的实例本身的资源模板,当程序退出这个实例的时候,又会因为析构函数的作用自动恢复原先的资源模板,极为方便.
MFC规则DLL并非MFC应用程序,他所包含的CWinApp类并不包含消息循环,因为规则DLL不包括MFC的CWinApp::Run()机制,主消息泵依然由应用程序拥有,如果DLL生成非模态对话框,或者自己
的主窗口框架,则应用程序的主消息泵必须调用从DLL导出来的函数来调用CWinApp的PreTranslateMessage()函数,将消息传送到DLL中
虽然没有DLLMain函数,但是MFC规则DLL包含另一个用于初始化DLL环境的函数InitInstance(),该函数在DLL项目的主APP入口类文件中,原型如下
1 // 唯一的一个 CDinkMfcRegularDllApp 对象 2 3 CDinkMfcRegularDllApp theApp; 4 5 6 // CDinkMfcRegularDllApp 初始化 7 8 BOOL CDinkMfcRegularDllApp::InitInstance() 9 {10 CWinApp::InitInstance();11 12 //初始化函数放在这里13 dllMessage.Empty();14 dllMessage.Append(TEXT("hello mfc regular dll"));15 16 return TRUE;17 } 和win32 dll一样,规则DLL也可以导出所需的类和函数以及变量,不过有了更方便的方法,MFC定义了三个宏,帮助我们快速导出,分别是
AFX_EXT_API AFX_EXT_DATA AFX_EXT_CLASS 分别用于导出函数,变量和类,实际上对应的是这三个条件宏,如下
#ifndef AFX_EXT_DATA #ifdef _AFXEXT #define AFX_EXT_CLASS AFX_CLASS_EXPORT #define AFX_EXT_API AFX_API_EXPORT #define AFX_EXT_DATA AFX_DATA_EXPORT #define AFX_EXT_DATADEF #else #define AFX_EXT_CLASS AFX_CLASS_IMPORT #define AFX_EXT_API AFX_API_IMPORT #define AFX_EXT_DATA AFX_DATA_IMPORT #define AFX_EXT_DATADEF #endif#endif
#ifndef AFX_DATA_EXPORT #define AFX_DATA_EXPORT __declspec(dllexport)#endif#ifndef AFX_DATA_IMPORT #define AFX_DATA_IMPORT __declspec(dllimport)#endif
#ifndef AFX_CLASS_EXPORT #define AFX_CLASS_EXPORT __declspec(dllexport)#endif#ifndef AFX_CLASS_IMPORT #define AFX_CLASS_IMPORT __declspec(dllimport)#endif// for global APIs#ifndef AFX_API_EXPORT #define AFX_API_EXPORT __declspec(dllexport)#endif#ifndef AFX_API_IMPORT #define AFX_API_IMPORT __declspec(dllimport)#endif
我们只需要在项目->属性->VC++->预处理中定义 _AFXEXT这个宏就可以了.
下面是一个实际的代码演示,首先是头文件
#pragma once#include "stdafx.h"//动态链接库版本#define DINK_MFC_REGULAR_DLL_VERSION 0.01#define DINK_MFC_REGULAR_DLL_NAME "DinkMfcRegularDll.dll"#define DINK_MFC_REGULAR_LIB_NAME "DinkMfcRegularDll.lib"//变量EXTERN_C CString AFX_EXT_DATA dllMessage;//动态导出变量,需要三个东西,一个是导出函数的load时候的字符串//第二个转换空指针到数据指针和实际数据的两个宏定义#define DINK_REGULAR_DLL_VAR_DLLMESSAGE "dllMessage"#define MAKE_REGULAR_DLL_DLLMESSAGE_PTR(ptr) ((CString*)ptr)#define MAKE_REGULAR_DLL_DLLMESSAGE_VALUE(ptr) (*((CString*)ptr))//全局方法EXTERN_C void AFX_EXT_API PathAppendName(CString path,CString name,CString& dst);typedef void (*DINK_REGULAR_FUNC_PATHAPPENDNAME)(CString path,CString name,CString& dst);#define DINK_REGULAR_DLL_NAME_FUNC_PATHAPPENDNAME "PathAppendName"EXTERN_C UINT AFX_EXT_API ShowConfirmDialog(CString& showString);//存放所有需要导出的MFC规则DLL的函数,变量,类的头文件//类不能动态导出,所以相对比较好一点//个人文件处理函数class AFX_EXT_CLASS CDinkFileLogic{public: //检测指定文件是否存在 BOOL FileIsExist(CString filePath,CString fileName); //读取指定文件的第一行文本 BOOL FileReadFirstLine(CString filePath,CString fileName,CString& readStr); //删除指定文件 BOOL FileRemove(CString filePath,CString fileName); //创建指定文件 force表示文件要是已经存在,是否删除并覆盖,为真,删除覆盖 BOOL FileCreate(CString filePath,CString fileName,BOOL force); //创建文件,并添加事件后缀,withTime表示是否添加时间,为false,则创建文件仅仅包含日期 BOOL FileCreateByTime(CString filePath,CString fileName,BOOL force,BOOL withTime); //文件写入一行,isCreate 表示当文件不存在是否主动创建 BOOL FileWriteLine(CString filePath,CString fileName,CString& writeStr,BOOL isCreate); //文件移动,moveOrCopy为真,为剪切操作 为假,是拷贝操作,如果目标文件已经存在,返回失败 BOOL FileMove(CString SourceFilePath,CString SourceFileName,CString dstFilePath,CString dstFileName,BOOL moveOrCopy); //文件移动,moveOrCopy为真,为剪切操作 为假,是拷贝操作,如果目标文件已经存在,默认覆盖该文件 BOOL FileMoveForce(CString SourceFilePath,CString SourceFileName,CString dstFilePath,CString dstFileName,BOOL moveOrCopy);protected:private: BOOL FileIsExist(CString fileFullPath);};//个人目录处理函数class AFX_EXT_CLASS CDinkDirLogic{public: //检测指定目录是否存在 BOOL DirIsExist(CString dirPath); //创建指定目录,如果目录已经存在,返回OK BOOL DirCreate(CString dirPath); //创建指定目录,目录名带时间,withTime为真,带时分秒 为假,仅仅年月日 BOOL DirCreateByTime(CString dirPath,BOOL withTime); //移除指定目录,只有在目录为空的时候才能执行 BOOL DirRemoveByEmpty(CString dirPath); //移除指定目录,不管目录是否为空 BOOL DirRemoveNoEmpty(CString dirPath); //检测目标文件夹是否还含有子文件,返回子文件个数 UINT IsDirContainFile(CString dirPath); //获取指定文件夹的子文件夹名和子文件夹个数 UINT DirListOfDir(CString dirPath,CArray & dirArray); //获取指定文件夹的子文件名列表和子文件个数 UINT FileListOfDir(CString dirPath,CArray & fileNameArray); //移动指定目录,withFile表示是带文件的移动还是仅仅移动目录 //不会删除源文件夹 UINT DirMove(CString sourceDirPath,CString dstDirPath,BOOL withFile);protected:private:}; 然后是与之对应的方法文件,数据文件和类文件,我习惯把三个文件分开,比较好维护,如下
#include "stdafx.h"#include "DinkMfcRegularDllExtend.h"BOOL CDinkFileLogic::FileIsExist(CString filePath,CString fileName){ AFX_MANAGE_STATE(AfxGetModuleState()); //检测文件是否存在 CStdioFile test; CString fileFullPath; PathAppendName(filePath,fileName,fileFullPath); if(test.Open(fileFullPath,CFile::modeRead)) { //可以打开 test.Close(); return TRUE; } else { return FALSE; }}BOOL CDinkFileLogic::FileIsExist(CString fileFullPath){ AFX_MANAGE_STATE(AfxGetModuleState()); CStdioFile test; if(test.Open(fileFullPath,CFile::modeRead)) { //可以打开 test.Close(); return TRUE; } else { return FALSE; }}BOOL CDinkFileLogic::FileReadFirstLine(CString filePath,CString fileName,CString& readStr){ AFX_MANAGE_STATE(AfxGetModuleState()); //读取制定文件第一行 CStdioFile test; CString fileFullPath; PathAppendName(filePath,fileName,fileFullPath); if(test.Open(fileFullPath,CStdioFile::modeRead)) { //打开了 readStr.Empty(); test.ReadString(readStr); test.Close(); return TRUE; } else { //文件打不开 return FALSE; }}BOOL CDinkFileLogic::FileRemove(CString filePath,CString fileName){ AFX_MANAGE_STATE(AfxGetModuleState()); CStdioFile test; CString fileFullPath; PathAppendName(filePath,fileName,fileFullPath); CFile::Remove(fileFullPath); return TRUE;}BOOL CDinkFileLogic::FileCreate(CString filePath,CString fileName,BOOL force){ AFX_MANAGE_STATE(AfxGetModuleState()); CStdioFile test; CString fileFullPath; PathAppendName(filePath,fileName,fileFullPath); if(force == TRUE) { //强制创建,如果存在,清除源文件内容 if(test.Open(fileFullPath,CStdioFile::modeRead|CFile::modeCreate)) { test.Close(); //已经存在文件 CFile::Remove(fileFullPath); return TRUE; } else { //创建失败 return FALSE; } } else { if(test.Open(fileFullPath,CFile::modeCreate|CFile::modeRead|CFile::modeNoTruncate)) { test.Close(); return TRUE; } else { return FALSE; } }}BOOL CDinkFileLogic::FileCreateByTime(CString filePath,CString fileName,BOOL force,BOOL withTime){ AFX_MANAGE_STATE(AfxGetModuleState()); CString timeStr; CTime time; time = time.GetCurrentTime(); if(withTime == TRUE) { timeStr.Append(time.Format(TEXT("%Y-%m-%d-%H-%M-%S-"))); } else { timeStr.Append(time.Format(TEXT("%Y-%m-%d-"))); } CString fileFullName(TEXT("")); fileFullName.Append(filePath); fileFullName.Append(TEXT("\\")); fileFullName.Append(timeStr); fileFullName.Append(fileName); CFile fileCreate; if(force == TRUE) { if(fileCreate.Open(fileFullName,CFile::modeRead|CFile::modeCreate)) { fileCreate.Close(); return TRUE; } else { return FALSE; } } else { if(fileCreate.Open(fileFullName,CFile::modeRead|CFile::modeNoTruncate|CFile::modeCreate)) { fileCreate.Close(); return TRUE; } else { return FALSE; } }}BOOL CDinkFileLogic::FileWriteLine(CString filePath,CString fileName,CString& writeStr,BOOL isCreate){ AFX_MANAGE_STATE(AfxGetModuleState()); CString fullName; PathAppendName(filePath,fileName,fullName); CStdioFile dinkFile; if(TRUE == isCreate) { //创建文件,如果文件已经存在就清空 if(dinkFile.Open(fullName,CFile::modeCreate|CFile::modeReadWrite)) { dinkFile.SeekToEnd(); dinkFile.WriteString(writeStr); dinkFile.Flush(); dinkFile.Close(); return TRUE; } else { //打开文件失败 return FALSE; } } else { //如果文件已经存在就打开而且不清空,不存在就创建 if(TRUE == dinkFile.Open(fullName,CStdioFile::modeReadWrite|CFile::modeCreate|CFile::modeNoTruncate)) { dinkFile.SeekToEnd(); dinkFile.WriteString(writeStr+TEXT("\n")); dinkFile.Flush(); dinkFile.Close(); return TRUE; } else { //打开文件失败 return FALSE; } }}BOOL CDinkFileLogic::FileMove(CString SourceFilePath,CString SourceFileName,CString dstFilePath,CString dstFileName,BOOL moveOrCopy){ AFX_MANAGE_STATE(AfxGetModuleState()); //文件移动 return FALSE;}BOOL CDinkFileLogic::FileMoveForce(CString SourceFilePath,CString SourceFileName,CString dstFilePath,CString dstFileName,BOOL moveOrCopy){ AFX_MANAGE_STATE(AfxGetModuleState()); return FALSE;} #include "stdafx.h"#include "DinkMfcRegularDllExtend.h"#include "DinkConfirmResultDialog.h"void PathAppendName(CString path,CString name,CString& dst){ AFX_MANAGE_STATE(AfxGetStaticModuleState()); dst.Empty(); if (path.IsEmpty()) { dst.Append(TEXT(".\\")); dst.Append(name); } else { dst.Append(path); dst.Append(TEXT("\\")); dst.Append(name); }}EXTERN_C UINT AFX_EXT_API ShowConfirmDialog(CString& showString){ AFX_MANAGE_STATE(AfxGetStaticModuleState()); CDinkConfirmResultDialog dialog(showString); int result; result = dialog.DoModal(); return result;} #include "stdafx.h"#include "DinkMfcRegularDllExtend.h"CString dllMessage;
对于资源模板,可以这样理解,应用程序及其调用的DLL每一个都有一个系统为之分配的HINSTANCE句柄,进程本身的模块句柄为0X400000(虚拟地址),而DLL的缺省句柄为0X00000000,如果程序加载多个DLL,则每个DLL都有一个不同的HINSSTANCE,
应用程序加载DLL的时候会对DLL进行重新定位.
HINSTANCE句柄对于加载资源十分重要,如果DLL需要加载资源就需要将资源句柄指定为DLL的资源句柄,应用程序也可以设置自己资源句柄为DLL的资源句柄,这样可以实现加载DLL的资源,具体在MFC中,切换资源句柄的方法有以下几种
1.DLL总调用AFX_MANAGE_STATE(AfxGetStaticModuleState()),主要用于DLL函数将应用程序的资源句柄切换为自身的资源句柄
2.在DLL接口函数调用
HINSTANCE exeHinstance = AfxGetResourceHandle();AfxSetResourceHandle(theApp.m_instance);//....接口代码AfxSetResourceHandle(exeHinstance);
实现的效果和第一种类似
3.应用程序自身切换,这种方法可以实现exe自身加载不同的资源
HINSTANCE exe_hinstance = GetModuleHandle(NULL);HINSTANCE dll_hinstance = GetModuleHandle("DLL名称");AfxSetResourceHandle(dll_hinstance);//调用dll函数,或者调用dll资源AfxSetResourceHandle(exe_hinstance);
以下为静态调用MFC规则DLL的演示程序,如下
//静态调用变量#include "..\\DinkMfcRegularDll\DinkMfcRegularDllExtend.h"#pragma comment(lib,DINK_MFC_REGULAR_LIB_NAME)void CDinkMfcRegularDllCallDlg::OnBnClickedButtonStaticShowVar(){ // TODO: 在此添加控件通知处理程序代码 CString showString(TEXT("load var str is : ")); showString.Append(dllMessage); MessageBox(showString,TEXT("message"),MB_OK);}//静态void CDinkMfcRegularDllCallDlg::OnBnClickedButtonStaticFuncCall(){ // TODO: 在此添加控件通知处理程序代码 CString str1(TEXT("F:\\MFC\\DinkDll\\DinkDll\\Release")); CString str2(TEXT("DinkMfcRegularDll.dll")); CString dstStr; PathAppendName(str1,str2,dstStr); MessageBox(dstStr,TEXT("message"),MB_OK);}//静态调用类void CDinkMfcRegularDllCallDlg::OnBnClickedButtonStaticClassCall(){ // TODO: 在此添加控件通知处理程序代码 CDinkFileLogic dinkFileLogic; CString str1(TEXT("F:\\MFC\\DinkDll\\DinkDll\\Release")); CString str2(TEXT("Hello.txt")); CString dstStr; if(dinkFileLogic.FileCreate(str1,str2,FALSE)) { if(dinkFileLogic.FileWriteLine(str1,str2,CString("hello world"),FALSE)) { MessageBox(TEXT("write file ok"),TEXT("message"),MB_ICONINFORMATION|MB_OK); } else { MessageBox(TEXT("write file failed"),TEXT("error"),MB_ICONERROR|MB_OK); } } else { MessageBox(TEXT("file create failed"),TEXT("error"),MB_ICONERROR|MB_OK); }}void CDinkMfcRegularDllCallDlg::OnBnClickedButtonShowDialog(){ // TODO: 在此添加控件通知处理程序代码 UINT result; result = ShowConfirmDialog(CString("hello world")); CString confirmShowMessage(TEXT("")); confirmShowMessage.AppendFormat(TEXT("dialog return value is %d"),result); MessageBox(confirmShowMessage,TEXT("message"),MB_ICONINFORMATION|MB_OK);} 以下为动态调用DLL
//动态变量显式void CDinkMfcRegularDllCallDlg::OnBnClickedButtonDynamicShowVar(){ // TODO: 在此添加控件通知处理程序代码 HMODULE dllModule; CString* str; dllModule = AfxLoadLibrary(TEXT(DINK_MFC_REGULAR_DLL_NAME)); if(dllModule != NULL) { str = MAKE_REGULAR_DLL_DLLMESSAGE_PTR(GetProcAddress(dllModule,DINK_REGULAR_DLL_VAR_DLLMESSAGE)); CString showString(TEXT("load var str is : ")); showString.Append(*str); MessageBox(showString,TEXT("message"),MB_OK); AfxFreeLibrary(dllModule); } else { MessageBox(TEXT("lib load failed"),TEXT("error"),MB_ICONERROR); }}//动态调用函数void CDinkMfcRegularDllCallDlg::OnBnClickedButtonDynamicCallFunc(){ // TODO: 在此添加控件通知处理程序代码 HMODULE dllModule; DINK_REGULAR_FUNC_PATHAPPENDNAME pathAddFunc; dllModule = AfxLoadLibrary(TEXT(DINK_MFC_REGULAR_DLL_NAME)); if(dllModule != NULL) { pathAddFunc = (DINK_REGULAR_FUNC_PATHAPPENDNAME)(GetProcAddress(dllModule,DINK_REGULAR_DLL_NAME_FUNC_PATHAPPENDNAME)); CString str1(TEXT("F:\\MFC\\DinkDll\\DinkDll\\Release")); CString str2(TEXT("DinkMfcRegularDll.dll")); CString dstStr; pathAddFunc(str1,str2,dstStr); MessageBox(dstStr,TEXT("message"),MB_OK); AfxFreeLibrary(dllModule); } else { MessageBox(TEXT("lib load failed"),TEXT("error"),MB_ICONERROR); }}
MFC规则DLL,1.动态的切换应用程序的资源.2.能够在DLL中使用MFC的API
但是MFC dll也不能动态的调用dll中的类,要使用类,使用静态调用.