MFC工程中不要#include <windows.h>

gaofeng

【原因分析篇章】


如果在MFC工程中#include   <windows.h>，那么会有以下编译错误（因为afxwin.h文件中包含了afx.h，afx.h文件中包含了afxver_.h，afxver_.h中包含了afxv_w32.h，而afxv_w32.h中包含了windows.h，请看以下分析）：
  compile   error:   
  c:\program   files\microsoft   visual   studio\vc98\mfc\include\afxv_w32.h(14)   :   
  fatal   error   C1189:   #error   :     WINDOWS.H   already   included.     MFC   apps   must   not   #include   <windows.h>   
            
  如果编译器在编译afxv_w32.h文件之前编译了windows.h文件，编译器会报上面的错误，因为在afxv_w32.h文件中有下面的一句预编译报警：   
  #ifdef   _WINDOWS_   
  #error   WINDOWS.H   already   included.     MFC   apps   must   not   #include   <windows.h>   
  #endif   
   
  问题在于为什么afxv_w32.h中要有这么一句预编译处理。看了afxv_w32.h和windows.h文件就有点明白了。   
  在afxv_w32.h中有下面的预编译语句：   
  ...   ...   
  #undef   NOLOGERROR   
  #undef   NOPROFILER   
  #undef   NOMEMMGR   
  #undef   NOLFILEIO   
  #undef   NOOPENFILE   
  #undef   NORESOURCE   
  #undef   NOATOM   
  ...   ...   
  在afxv_w32.h中还有一句：   
  #include   "windows.h"   
   
  而在windows.h文件中有下面的预编译语句：   
  ...   ...   
  #define   NOATOM   
  #define   NOGDI   
  #define   NOGDICAPMASKS   
  #define   NOMETAFILE   
  #define   NOMINMAX   
  #define   NOMSG   
  #define   NOOPENFILE   
  ...   ...   
   
  注意到在windows.h的开头有防止windows.h被重复编译的预编译开关：   
  #ifndef   _WINDOWS_   
  #define   _WINDOWS_   
   
  这样问题就明白了，虽然我不知道微软为什么要这么做，但是我知道如果在afxv_w32.h没有那句预编译报警，那么如果在编译afxv_w32.h之前   
  编译了windows.h，那么在windows.h中#define的NOATOM等宏就会被#undef掉，可能会导致相应的错误发生。   
   
  猜想原因可能如上所述，我的解决方法是，将包含有#include   “windows.h"的头文件放在所有包含的头文件的最后面，这样使得对afxv_w32文件   
  的编译处理发生在先，这样，由于在afxv_w32.h中已经包含了windows.h，那么宏_WINDOWS_将被定义，后继的#include   "windows.h"语句将形同虚设，   
  上面的编译报警也不会发生了。我觉得这种处理要比将所有的#include   "windows.h”语句删掉要好一点。   
   
  一句话，编译器必须在编译windows.h之前编译afxv_w32.h,因为我不是十分清除什么时候afxv_w32.h会被编译，所以我将可能包含有#include   "windows.h"的头文件放在其他头文件之后#include。

---------------------------------------------------------------------------------------------

---------------------------------------------------------------------------------------------

【处理篇】


一、问题由来



vc6和vc71的工程向导中都包含非MFC的工程，诸如win32 console project, win32 static library。非MFC工程创建时是不支持MFC特性的，然后我们在处理实际问题时有时会用到MFC相关类，如Cstring, Cedit等等，这是很正常的。可能有人会说，为何不在一开始就创建MFC工程呢？问题在于MFC工程会产生很多向导生成代码，如基于单文档的工程会有View,Doc等类，很多时候我们只需要一个空工程就可以了。





二、常见问题

非MFC工程使用MFC库时最常见的问题就是windows.h重复包含错误，具体如下：

fatal error C1189: #error :  WINDOWS.H already included.  MFC apps must not #include <windows.h>





三、解决办法

非MFC工程使用MFC库时，可参考以下步骤

1、工程设置中，将MFC的使用由原来的“使用标准windows库”改为“在共享DLL中使用MFC”（VC71）

如果是英文版，相关选项是：

Microsoft Foundation Classes: Use MFC in a shared dll, no using MFC（VC6）

NOTE:因为我用的是中文版的vc71,英文版的vc6.

2、头文件包含

不同的MFC类需包含的头文件是不一样的。

常用的类，如Cstring, Cedit 等，包含afxwin.h就可以了

如果不清楚包含什么头文件的话，可以同msdn进行查询，msdn中，对于MFC类的介绍中，都会给出相应的header file requirement.

3、＃include 语句一定要写在首行

这一点很重要，通常出现前面讲到的windows.h重复包含错误，都是因为#include 语句没有写在首行。

另外还要注意的是，如果#include语句是在一个头文件里，那么对应头文件的包含也要写在首行。示例如下：

＝＝＝＝＝＝＝＝＝＝＝＝＝

test.h文件的内容如下：

＃include <afxwin.h> //保证该语句在首行

test.cpp的文件内容如下：

#include “test.h” //同样也要保证该语句在首行

＝＝＝＝＝＝＝＝＝＝＝＝＝

ps: 这么做的具体原因我也不知道，我是在实际调试中琢磨出这个道理的。我自己在这个问题上花了很多冤枉时间，写下该篇，就是希望大家不要在这个问题上绊脚。