vc宏总结

C/C++中的宏

宏的单行定义

#define A(x) T_##x

#define B（x) #@x

#define C（x) #x

我们假设：x=1，则有：

A(1)------〉T_1

B(1)------〉'1'

C(1)------〉"1"

define可以替代多行的代码，例如MFC中的宏定义（非常的经典，虽然让人看了恶心）

#define MACRO(arg1, arg2) do { \

/* declarations */ \

stmt1; \

stmt2; \

/* ... */ \

} while(0) /* (no trailing ; ) */

关键是要在每一个换行的时候加上一个"\"

MFC中常用宏及其作用如下:

RUNTIME_CLASS获得运行时类的CRuntimeClass结构指针RUNTIME_CLASS( class_name )

DECLARE_DYNAMIC提供基本的运行时类型识别(声明) DECLARE_DYNAMIC( class_name )

IMPLEMENT_DYNAMIC提供基本的运行时类型识别(实现) IMPLEMENT_DYNAMIC (class_name, base_class_name )

DECLARE_DYNCREATE动态创建(声明) DECLARE_DYNCREA TE( class_name ) IMPLEMENT_DYNCREATE动态创建(实现) IMPLEMENT_DYNCREATE( class_name,base_class_name )

DECLARE_SERIAL对象序列化(声明) DECLARE_SERIAL( class_name )

IMPLEMENT_SERIAL对象序列化(实现)IMPLEMENT_SERIAL(class_name,base_class_name,wSchema)

DECLARE_MESSAGE_MAP声明消息映射表DECLARE_MESSAGE_MAP()

BEGIN_MESSAGE_MAP开始建立消息映射表BEGIN_MESSAGE_MAP( theClass, baseClass )

END_MESSAGE_MAP结构建立消息映射表END_MESSAGE_MAP()

ON_COMMAND命令消息映射宏

ON_MESSAGE自定义消息映射宏

ON_WM_...MFC预定义消息映射宏

ON_BN_...,ON_EN_..控件通知消息映射宏

部分宏说明:

a.RUNTIME_CLASS宏使程序能实时创建类的实例。为了让这个宏起作用，定义的类必须从CObject类派生而来，并且在派生类的定义中必须使用宏

DECLARE_DYNAMIC,DECLARE_DYNCREATE或DECLARE_SERIAL,在派生类的实现文件中必须使用宏IMPLEMENT_DYNAMIC,IMPLEMENT_DYNCREATE或IMPLEMENT_SERIAL。

b.DECLARE_DYNAMIC只能使CObject派生类对象具有基本的类型识别功能，可以通过CObject::IsKindOf(ClassName)测试对象与给定类ClassName的关系。

c.DECLARE_DYNCREATE包括了DECLARE_DYNAMIC的功能。DECLARE_SERIAL 包括了DECLARE_DYNAMIC和DECLARE_DYNCREATE的功能。

3.MFC调试宏

a.跟踪宏:TRACE(<表达式>)

b.断言宏:ASSERT(<表达式>)当ASSERT宏的参数不为真时，暂停程序的执行。如果表达式的值为真，则不做任何事情。如果参数为假时，则暂停程序的执行并弹出一个对话框，告诉用户程序暂停运行的行以及所在文件信息。用户可以根据情况选择终止程序运行，调试程序或继续运行。

c.断言有效宏ASSERT_V ALID ASSERT_V ALID(<指针>)该宏用于检查指针和对象的用效性。对于一般指针，只检查指针是否为空。对于MFC对象指针，还调用CObject::AssertValid()成员含数判断对象是否合法。ASSERT_V ALID与ASSERT类似，也是使用对话框提示用户指针或对象是无效的。如果对象有效，则不做任何事情.

https://www.360docs.net/doc/8518830050.html, IDE预定义宏

这类宏主要应用在工程属性设置中，包括名称、路径、编译等相关字符串。比如解决方案位c:\Soln\Soln.sln，项目位于c:\Soln\Proj\Proj.vcproj，中间目录为DebugInt，输出目录为c:\MyOutputs，输出名称为Game.exe时，各个宏的值依次如下。

$(ConfigurationName) 版本名，如debug或release。

$(PlatformName) 当前平台名，如Win32。

$(IntDir) 中间目录名，即为中间文件指定的相对于项目目录的目录路径，值为DebugInt。

$(OutDir) 输出文件目录的路径，值为c:\MyOutputs。

$(DevEnvDir) VS的安装目录。

$(InputDir) 输入文件目录，值为c:\Soln\Proj。

$(InputPath) 输入文件全路径名，值为c:\Soln\Proj\Proj.vcproj。

$(InputName) 输入文件名，值为Proj。

$(InputFileName) 输入文件名（带后缀），值为Proj.vcproj。

$(InputExt) 输入文件扩展名，值为.vcproj。

$(ProjectDir) 项目目录，同$(InputDir)。

$(ProjectPath) 项目全路径名，同$(InputPath)。

$(ProjectName) 同$(InputName)。

$(ProjectFileName) 同$(InputFileName)。

$(ProjectExt) 同$(ProjectExt)。

$(SolutionDir) 解决方案目录，值为c:\Soln。

$(SolutionPath) 解决方案路径，值为c:\Soln\Soln.sln。

$(SolutionName) 解决方案名，值为Soln。

$(SolutionFileName) 解决方案名（带后缀），值为Soln.sln。

$(SolutionExt) 解决方案文件扩展名，值为.sln。

$(TargetDir) 输出文件目录，值为c:\MyOutputs\。

$(TargetPath) 输出文件路径名，c:\MyOutputs\Game.exe。

$(TargetName) 输出文件名，值为Game。

$(TargetFileName) 输出文件全名，值为Game.exe。

$(TargetExt) 输出文件扩展名，值为.exe。

$(VSInstallDir) VS安装目录。

$(VCInstallDir) VC安装目录。

$(FrameworkDir) framework安装目录。

$(FrameworkVersion) framework版本信息。

$(FrameworkSDKDir) framework sdk安装目录。

__cplusplus 如果当前编译器为C++，该值为1。

__DATE__ 当前源码的编译日期，格式为Mmm dd yyyy。

__TIME__ 当前源码的编译时间，格式为hh:mm:ss。

__TIMESTAMP__ 当前源码文件最后被修改的日期和时间，格式为Ddd Mmm Date hh:mm:ss yyyy。

__FILE__ 当前源码文件名。

__LINE__ 当前插入点所在源码的行号。

__FUNCTION__ 当前插入点所在函数名。

__STDC__ 标识是否严格遵循ANSI C标准，编译器选项/Za被设置时该宏定义为1，表示遵循标准。

__V A_ARGS__可变参数宏，用来传递可变参数表；该宏并非被所有编译器支持。

_DEBUG当我们的工程设置为debug版编译时，编译器会定义该宏；该宏与#ifdef等预编译语句一起进行条件编译，以区分debug和release版本功能。

ASSERT 断言，当该宏后面的语句值为0时引起程序中断，只在debug版中有效。

VERIFY与ASSERT功能类似，在debug和release版本中均有效。

ASSERT_V ALID检查后面参数指针是否为空，只在debug版中有效。

TRACE格式化输出字符串信息。

_ATL_VER指明A TL的版本。

_CLR_VER指明公共运行时（common language runtime）的版本。

_COUNTER_一个从0开始的全局的计数器，每次用于源文件或在源文件中被引用头文件时，自动加1。

_DLL当工程类型为动态链接库时，该值为1。

WINVER指示Windows版本。

_MFC_VER指示MFC版本。

_MSC_VER指示编译器版本。

_WIN32 为Win32和Win64程序定义。

＃include指令包含指定的文件

#define指令预定义,通常用它来定义常量(包括无参量与带参量)，以及用来实现那些“表面似和善、背后一长串”的宏，它本身并不在编译过程中进行，而是在这之前(预处理过程)就已经完成了

#typedef指令常用来定义一个标识符及关键字的别名它是语言编译过程的一部分，但它并不实际分配内存空间。

#ifndef #else #endif指令

条件编译。一般情况下，源程序中所有的行都参加编译。但是有时希望对其中一部分内容只在满足一定条件才进行编译，也就是对一部分内容指定编译的条件，这就是“条件编译”。有时，希望当满足某条件时对一组语句进行编译，而当条件不满足时则编译另一组语句。

条件编译命令最常见的形式为：

#ifdef 标识符

程序段1

#else

程序段2

#endif

它的作用是：当标识符已经被定义过(一般是用#define命令定义)，则对程序段1进行编译，否则编译程序段2。

#ifdef _DEBUG

是编译时预定义的符号，是VC环境默认产生的，在设置中可以找到表示现在的运行模式时调试态

#define new DEBUG_NEW

把new 这个关键字用DEBUG_NEW 这个宏替代，在调试状态能检测内存泄露

和帮助管理内存。

#undef THIS_FILE undef和enddif的含义是什么？THIS_FILE是自己编写的？还是系统默认的指定用词？

undef是取消一个符号定义。endif是便是一条件编译的结束。THIS_FILE就是一个普通的符号名。取消定义后，下面就能安全使用了。

__FILE__是编译器预定义的符号，就是正在编译的文件名。这句话就是声明一个静态的字符串THIS_FILE。相当于：static char THIS_FILE[] = "a.c";

预处理和宏定义又是C语言的一个强大工具。使用它们可以进行简单的源代码控制，版本控制，预警或者完成一些特殊的功能。

一个经典的例子

使用预处理与宏定义最经典的例子莫过于加在一个头文件中以避免头文件被两次编译。试想这种的情况，有一个文件headerfile.h 它被包含在headerfile1.h中，同时在headerfile2.h 中也被包含了，现在有一个CPP文件，implement.cpp 包含了headerfile1.h 和headerfile2.h：#include “headerfile1.h”

#include “headerfile2.h”

假设headerfile.h 中定义了一个全局变量iglobal 。

int iglobal;

在编译的时候编译器两次编译headerfile，也就会发现iglobal被定义了两次，这时就会发生变量重定义的编译错误。

传统的解决办法是使用#ifdef 以及#endif 来避免头文件的重复编译，在上面的例子中，只需要加上这么几行：

#ifndef smartnose_2002_6_21_headerfile_h

#define smartnose_2002_6_21_headerfile_h

int iglobal;

#endif

仔细的考虑上面的宏定义，会发现当编译器编译过一次headerfile.h以后，smartnose_2002_6_21_headerfile_h 这个宏就被定义了，以后对headerfile.h的编译都会跳过int iglobal 这一行。当然smartnose_2002_6_21_headerfile_h 这个宏是可以任意定义的，但是这个宏本身不能和其它文件中定义的宏重复，所以MFC在自动生成的文件中总是使用一个随机产生的长度非常长的宏，但我觉得这没有必要，我建议在这个宏中加入一些有意义的信息，比方作者，文件名，文件创建时间等等，因为我们有时候会忘记在注释中加入这些信息。

在https://www.360docs.net/doc/8518830050.html, 中我们不会再看见这些宏定义了，因为在这里会普遍使用一个预处理指令：#pragma once

只要在头文件的最开始加入这条指令就能够保证头文件被编译一次，这条指令实际上在VC6中就已经有了，但是考虑到兼容性并没有太多的使用它。

源代码版本控制

当我们为许多平台开发多个版本的时候预编译指令和宏定义也能够帮我们的忙。假设我们现在为WINDOWS 和LINUX开发了一套软件，由于这两种系统的不同，我们不得不在程序控制源代码的版本。比方内存的分配，我们可以在LINUX上使用标准C的malloc 函数，但是我们希望在WINDOWS上使用HeapAlloc API。下面的代码演示了这种情况：main()

{

………………..

#ifdef _WINDOWS_PLATFORM

HeapAlloc(5);

#else

malloc(5);

#endif

………………..

}

当我们在WINDOWS 平台上编译此程序的时候，只需要定义_WINDOWS_PLATFORM 这个宏，那么HeapAlloc这条语句就能够起作用了。这样就能够让我们在同一个文件中为不同的平台实现不同版本的代码，同时保持程序的良好结构。在许多情况下，我们还可以为一个方法使用不同的算法，然后用宏定义来针对不同的情况选择其中的一个进行编译。这在MFC应用程序中是使用得最多的。最明显的就是文件中经常存在的

#ifdef _DEBUG

…………………….some code………..

#endif

这样的代码，这些代码在应用程序的调试版（DEBUG）中会发挥其作用。

#Pragma 指令

在所有的预处理指令中，#Pragma 指令可能是最复杂的了，它的作用是设定编译器的状态或者是指示编译器完成一些特定的动作

。其格式一般为

#Pragma Para

其中Para 为参数，下面来看一些常用的参数。

message 参数。Message 参数是我最喜欢的一个参数，它能够在编译信息输出窗口中输出相应的信息，这对于源代码信息的控制是非常重要的。其使用方法为：#Pragma message(“消息文本”)

当编译器遇到这条指令时就在编译输出窗口中将消息文本打印出来。当我们在程序中定义了许多宏来控制源代码版本的时候，我们自己有可能都会忘记有没有正确的设置这些宏，此时我们可以用这条指令在编译的时候就进行检查。假设我们希望判断自己有没有在源代码的什么地方定义了_X86这个宏可以用下面的方法

#ifdef _X86

#Pragma message(“_X86 macro activated!”)

#endif

当我们定义了_X86这个宏以后，应用程序在编译时就会在编译输出窗口里显示“_X86 macro activated!”。我们就不会因为不记得自己定义的一些特定的宏而抓耳挠腮了。

另一个使用得比较多的pragma参数是code_seg。格式如：

#pragma code_seg( ["section-name"[,"section-class"] ] )

它能够设置程序中函数代码存放的代码段，当我们开发驱动程序的时候就会使用到它。

最后一个比较常用的就是上面所说的#pragma once 指令了。

#pragma hdrstop

表示预编译头文件到此为止，后面的头文件不进行预编译。BCB可以预编译头文件以加快链接的速度，但如果所有头文件都进行预编译又可能占太多磁盘空间，所以使用这个选项排除一些头文件。有时单元之间有依赖关系，比如单元A依赖单元B，所以单元B要先于单元A编译。你可以用#pragma startup指定编译优先级，如果使用了#pragma package(smart_init) ，BCB就会根据优先级的大小先后编译。

#pragma resource "*.dfm"

表示把*.dfm文件中的资源加入工程。*.dfm中包括窗体外观的定义。

#pragma warning( disable : 4507 34; once : 4385; error : 164 )等价于：

#pragma warning(disable:4507 34) // 不显示4507和34号警告信息

#pragma warning(once:4385) // 4385号警告信息仅报告一次

#pragma warning(error:164) // 把164号警告信息作为一个错误。

同时这个pragma warning 也支持如下格式：

#pragma warning( push [ ,n ] )

#pragma warning( pop )

这里n代表一个警告等级(1---4)。

#pragma warning( push )保存所有警告信息的现有的警告状态。

#pragma warning( push, n)保存所有警告信息的现有的警告状态，并且把全局警告

等级设定为n。

#pragma warning( pop )向栈中弹出最后一个警告信息，在入栈和出栈之间所作的

一切改动取消。例如：

#pragma warning( push )

#pragma warning( disable : 4705 )

#pragma warning( disable : 4706 )

#pragma warning( disable : 4707 )

//.......

#pragma warning( pop )

在这段代码的最后，重新保存所有的警告信息(包括4705，4706和4707)。

#pragma comment(...)

该指令将一个注释记录放入一个对象文件或可执行文件中。

常用的lib关键字，可以帮我们连入一个库文件。

每个编译程序可以用#pragma指令激活或终止该编译程序支持的一些编译功能。例如，对循环优化功能：

#pragma loop_opt(on) // 激活

#pragma loop_opt(off) // 终止

有时，程序中会有些函数会使编译器发出你熟知而想忽略的警告，如“Parameter xxx is never used in function xxx”，可以这样：

#pragma warn —100 // Turn off the warning message for warning #100

int insert_record(REC *r)

{ /* function body */ }

#pragma warn +100 // Turn the warning message for warning #100 back on

函数会产生一条有唯一特征码100的警告信息，如此可暂时终止该警告。

每个编译器对#pragma的实现不同，在一个编译器中有效在别的编译器中几乎无效。可从编译器的文档中查看。

VC预定义的宏

宏：__LINE__ 和__FILE__

定义源程序文件名和代码行，这对于调试跟踪代码错误行很有帮助。

__TIME__ ：编译时间

__DATE__ ：编译日期

__TIMESTAMP__：文件修改时间

在VC中有一类宏并不是由用户用#define语句定义的，而是编译器本身就能够识别它们。这些宏的作用也是相当大的。让我们来看第一个，也是MFC中使用得最频繁的一个:__FILE__ 。当编译器遇到这个宏时就把它展开成当前被编译文件的文件名。好了，我们马上就可以想到可以用它来做什么，当应用程序发生错误时，我们可以报告这个错误发生的程序代码在哪个文件里，比方在文件test.cpp中有这样的代码：

try{char * p=new(char[10]);}

catch(C Exception *e ){TRACE(“ there is an error in file: %s\n”,__FILE__);}

在程序运行的时候，如果内存分配出现了错误，那么在调试窗口中会出现there is an error in file: test.cpp 这句话，当然，我们还可以把这个错误信息显示在别的地方。如果我们还能够记录错误发生在哪一行就好了，幸运的是，与__FILE__宏定义一样，还有一个宏记录了当前代码所在的行数，这个宏是__LINE__。使用上面的两个宏，我们可以写出一个类似于VC提供的ASSERT语句。下面是方法

#define MyAssert(x) \

if(!(x)) \

MessageBox(__FILE__,__LINE__,NULL,MB_OK);

我们在应用程序中可以象使用ASSERT语句一样使用它，在错误发生时，它会弹出一个对话框，其标题和内容告诉了我们错误发生的文件和代码行号，方便我们的调试，这对于不能使用ASSERT语句的项目来说是非常有用的。

除了这两个宏以外，还有记录编译时间的__TIME__，记录日期的__DATE__，以及记录文件修改时间的__TIMESTAMP__宏。使用这些预定义的宏，我们几乎可以生成和VC能够生成的一样完整的源代码信息报表。翻开MFC和Linux的源代码，宏定义几乎占据了半边天，消息映射，队列操作，平台移植，版本管理，甚至内核模块的拆卸安装都用宏定义完成。毫不夸张的说，有些文件甚至就只能看见宏定义。所以学习宏定义，熟练的使用宏定义对于学习C语言乃至VC都是非常关键的。

下面要介绍的宏定义与预处理指令的用法也是ATL，MFC以及LINUX中使用得比较多的非常重要的技巧。

## 连接符与# 符

##连接符号由两个井号组成，其功能是在带参数的宏定义中将两个子串(token)联接起来，从而形成一个新的子串。但它不可以是第一个或者最后一个子串。所谓的子串(token)就是指编译器能够识别的最小语法单元。具体的定义在编译原理里有详尽的解释，但不知道

也无所谓。同时值得注意的是#符是把传递过来的参数当成字符串进行替代。下面来看看它们是怎样工作的。这是MSDN上的一个例子。

假设程序中已经定义了这样一个带参数的宏：

#define paster( n ) printf( "token" #n " = %d", token##n )

同时又定义了一个整形变量：

int tokenArray = Array;

现在在主程序中以下面的方式调用这个宏：

paster( Array );

那么在编译时，上面的这句话被扩展为：

printf( "token" "Array" " = %d", tokenArray )；

注意到在这个例子中，paster(Array);中的这个”Array”被原封不动的当成了一个字符串，与”token”连接在了一起，从而成为了tokenArray。而#n也被”Array”所替代。

可想而知，上面程序运行的结果就是在屏幕上打印出tokenArray=Array

在ATL的编程中，我们查看它的源代码就会经常看见这样的一段：

#define IMPLEMENTS_INTERFACE(Itf) ＼

{&IID_##Itf, ENTRY_IS_OFFSET,BASE_OFFSET(_ITCls, Itf) },

我们经常不假思索的这样使用它：……

IMPLEMENTS_INTERFACE(ICat)

……

实际上IID_ICat 已经在别的地方由ATL向导定义了。当没有向导的时候，你只要遵循把IID_加在你的接口名前面来定义GUID的规则就也可以使用这个宏。在实际的开发过程中可能很少用到这种技巧，但是A TL使用得如此广泛，而其中又出现了不少这样的源代码，所以明白它是怎么一回事也是相当重要的。我的一个朋友就是因为不知道IMPLEMENTS_INTERFACE宏是怎么定义的，而又不小心改动了IID_ICat的定义而忙活了一整天。

Linux的怪圈在刚开始阅读Linux的时候有一个小小的宏让我百思不得其解：

#define wait_event(wq,condition) ＼

do{ ＼

if(condition) ＼

break; ＼

__wait_event(wq,condition); ＼

}while(0)

这是一个奇怪的循环，它根本就只会运行一次，为什么不去掉外面的do{..}while结构呢？我曾一度在心里把它叫做“怪圈”。原来这也是非常巧妙的技巧。在工程中可能经常会引起麻烦，而上面的定义能够保证这些麻烦不会出现。下面是解释：

假设有这样一个宏定义

#define macro(condition) ＼

if(condition) dosomething();

现在在程序中这样使用这个宏：

if(temp)

macro(i);

else

doanotherthing();

一切看起来很正常，但是仔细想想。这个宏会展开成：

if(temp)

if(condition) dosomething();

else

doanotherthing();

这时的else不是与第一个if语句匹配，而是错误的与第二个if语句进行了匹配，编译通过了，但是运行的结果一定是错误的。为了避免这个错误，我们使用do{….}while(0) 把它包裹起来，成为一个独立的语法单元，从而不会与上下文发生混淆。同时因为绝大多数的编译器都能够识别do{…}while(0)这种无用的循环并进行优化，所以使用这种方法也不会导致程序的性能降低。

几个小小的警告

正如微软声称的一样，宏定义与预编译器指令是强大的，但是它又使得程序难以调试。所以在定义宏的时候不要节省你的字符串，一定要力争完整的描述这个宏的功能。同时在定义宏的时候如有必要（比方使用了if语句）就要使用do{…}while(0)将它封闭起来。在宏定义的时候一定要注意各个宏之间的相互依赖关系，尽量避免这种依赖关系的存在。下面就有这样一个例子。

设有一个静态数组组成的整型队列，在定义中使用了这样的方法：int array[]={5, 6, 7, 8};

我们还需要在程序中遍历这个数组。通常的做法是使用一个宏定义

#define ELE_NUM 4

…………………………..

……………………………..

for(int I=0;I

{

cout<

}

由于某种偶然的原因，我们删除了定义中的一个元素，使它变成：array[]={5,6,7}而却忘了修改ELE_NUM的值。那么在上面的代码中马上就会发生访问异常，程序崩溃。然后是彻夜不眠的调试，最后发现问题出在这个宏定义上。解决这个问题的方法是不使用

array[]={….}这样的定义，而显式的申明数组的大小：

array[ELE_NUM]={….}

这样在改动数组定义的时候，我们就不会不记得去改宏定义了。总之，就是在使用宏定义的时候能够用宏定义的地方统统都用上。我发现的另一个有趣的现象是这样的：假设现在有一个课程管理系统，学生的人数用宏定义为：#define STU_NUM 50而老师的人数恰好也是50人，于是很多人把所有涉及到老师人数的地方通通用上STU_NUM这个宏。另一个学期过去，学生中的一个被开除了，系统需要改变。怎么办呢？简单的使用#define STU_NUM 4Array 么？如果是这样，一个老师也就被开除了，我们不得不手工在程序中去找那些STU_NUM宏然后判断它是否是表示学生的数目，如果是，就把它改成4Array。天哪，这个宏定义制造的麻烦比使用它带来的方便还多。正确的方法应该是为老师的数目另外定义一个宏：#define TEA_NUM 50当学生的数目改变以后只要把STU_NUM 定义为4Array 就完成了系统的更改。所以，当程序中的两个量之间没有必然联系的时候一定不要用其中的一个宏去替代另一个，那只会让你的程序根本无法改动。最后，建议C/C++语言的初学者尽

可能多的在你的程序中使用宏定义和预编译指令。多看看MFC，ATL或者LINUX的源代码，你会发现C语言强大的原因所在。

TRACE

TRACE(exp)

说明：把一个格式化字符串送到转储设备，例如，文件或调试监视器，而提供与printf相似的功能。同MS_DOS下C程序的printf一样，TRACE宏是一个在程序运行时跟踪变量值的方便形式。在DEBUG环境中，TRACE宏输出到afxDump。在Release版中他不做任何工作。

注释：此宏只在MFC的DEBUG版中有效。

TRACE0

TRACE0(exp)

说明：与TRACE相似，但他把跟踪字符串放在代码段中，而不是DGROUP,因此使用少的DGROUP空间。TRACE0是一组跟踪宏的一个变体，这些宏可用于调试输出。这一组包括TRACE0,TRACE1,TRACE2和TRACE3,这些宏不同在于所取参数的数目不同。TRACE0只取一个格式化字符串并可用于简单文本消息。TRACE1取一格式化字符串加上一个变量——一个将转储的变量。同样，TRACE2,TRACE3分别取2个或3个参数（在格式化字符串之后）。如果用户以便以了应用程序的发行版，那么它只把数据转储到afxDump。

注释：此宏只在MFC的DEBUG中有效。

TRACE1

TRACE1(exp,param1)

TRACE2

TRACE2(exp,param1,param2)

TRACE3

TRACE3(exp,param1,param2,param3)

THROW

THROW(exception_object_pointer)

说明：派出指定的异常。THROW中断程序的运行，把控制传递给用户程序中的相关的CA TCH块。如果用户没有提供CA TCH块，那么控制被传递到一个MFC模块，他打印出一个错误并终止运行。

THROW_LAST

THROW_LAST()

说明：此宏允许用户派出一个局部建立的异常。如果用户试图排除一个刚发现的异常，那么一般此异常将溢出并被删除。使用THROW_LAST,此异常被直接传送到下一个CATCH处理程序。

TRY

TRY

说明：使用此宏建立一TRY块。一个TRY识别一个可排除异常的代码块。这些异常在随后的CATCH和AND_CA TCH块处理。传递是允许的：异常可以传递一个外部TRY块，或者忽略它们或者使用THROW_LAST宏。

CA TCH

CA TCH(exception_class,exception_object_pointer_name)

说明：使用此用定义一个代码块，此代码用来获取当前TRY块中都一个异常类型。异常处理代码可以访问异常对象，如何合适的话，就会得到关于异常的特殊原因的更多消息。调用THROW_LAST宏以把处理过程一下一个外部异常框架，如果exception-class是类

CExceptioon,那么会获取所有异常类型。用户可以使用CObject::IsKindOf成员函数以确定那个特别异常被排除。一种获取异常的最好方式是使用顺序的AND_CATCH语句，每个带一个不同的异常类型。此异常类型的指针由宏定义，用户不必定义。

注释：此CATCH块被定义作一个C++范围（由花括号描述）。如用户在此范围定义变量，那么它们只在吃范围内可以访问。他还可以用于异常对象的指针名。

END_CATCH

END_CATCH

说明：标识最后的CA TCH或AND_CA TCH块的末尾。

AND_CATCH

AND_CATCH(exception_class,exception _object_point_name)

说明：定义一个代码块，它用于获取废除当前TRY块中的附加异常类型。使用CATCH宏以获得一个异常类型，然后使用AND_CATCH宏获得随后的异常处理代码可以访问异常对象（若合适的话)已得到关于异常的特别原因的更多消息。在AND_CATCH块中调用THROW_LAST宏以便把处理过程移到下个外部异常框架。AND_CA TCH可标记CA TCH或AND_CATCH块的末尾。

注释：AND_CATCH块被定义成为一个C++作用域（由花括号来描述）。若用户在此作用域定义变量，那么记住他们只在此作用域中可以访问。他也用于exception_object_pointer_name变量。

调试宏：ASSERT()、VERIFY()、TRACE()

这三个宏在Debug环境下特别有效，常用于代码的跟踪调试。它们是否起作用取决于是否定义了预定义了宏_DEBUG

VERIFY

VERIFY(booleanExpression)

说明：在MFC的DEBUG版中，VERIFY宏计算它的变量值。如果结果为0，那么宏打印一个诊断消息并中止程序。如果条件不为0，那么什么工作也不作。诊断有如下形式：assertion failed in file in line 其中name是源文件的名字，num是在源文件中失败的中止行号。在MFC的Release版中，VERIFY计算表达式值但不打印或中止程序。例如：如果表达式是个函数调用，那么调用成功。

ASSERT

ASSERT(booleanExpression)

说明：计算变量的值。如果结构的值为0，那么此宏便打印一个诊断消息并且表示运行失败。如果条件为非0，那么什么也不做。诊断消息的形式为：assertion failed in file in line 其中name是元文件名，num是源文件中运行失败的中断号。在Release版中，ASSERT不计算表达式的值也就不中断程序。如果必须计算此表达式的值且不管环境如何那么用VERIFY 代替ASSERT。

注释：ASSERT只能在Debug版中用

ASSERT_V AILD

ASSERT_V AILD(pObject)

说明：用于检测关于对象的内部状态的有效性。ASSERT_V ALID调用此对象的AssertValid 成员函数（把它们作为自己的变量来传递）。在Release版中ASSERT_V ALID什么也不做。在DEBUG版中，他检查指针，以不同于NULL的方式进行检查，并调用对象自己的AssertValid成员函数。如果这些检测中有任何一个失败的话，那么他会以与ASSERT相同的方法显示一个警告的消息。

注释：此函数只在DEBUG版中有效。

DECLARE_MESSAGE_MAP()

说明：用户程序中的每个CCmdTarget派生类必须提供消息映射以处理消息。在类定义的末尾使用DECLARE_MESSAGE_MAP宏。接着，在定义类成员函数的.CPP文件中，使用BEGIN_MESSAGE_MAP宏，每个用户消息处理函数的宏项下面的列表以及END_MESSAGE_MAP宏。

注释：如果在DECLARE_MESSAGE_MAP之后定义任何一个成员，那么必须为他们指定一个新存取类型（公共的，私有的，保护的）。

BEGIN_MESSAGE_MAP

BEGIN_MESSAGE_MAP(the class,baseclass)

说明：使用BEGIN_MESSAGE_MAP开始用户消息映射的定义。在定义用户类函数的工具（.cpp）文件中，以BEGIN_MESSAGE_MAP宏开始消息映射，然后为每个消息处理函数增加宏项，接着以END_MESSAGE_MAP宏完成消息映射。

END_MESSAGE_MAP

END_MESSAGE_MAP

说明：使用END_MESSAGE_MAP宏结束用户的消息映射定义

DEBUG_NEW

#define new DEBUG_NEW

说明：帮助查找内存错误。用户在程序中使用DEBUG_NEW,用户通常使用new运算符来从堆上分配。在Debug模式下（但定义了一个DEBUG符号），DEBUG_NEW为它分配的每个对象记录文件名和行号。然后，在用户使用CMemoryState::DumpAllObjectSince成员函数时，每个以DEBUG_NEW分配的对象分配的地方显示出文件名和行号。为了使用DEBUG_NEW,应在用户的资源文件中插入以下指令：#define new DEBUG_NEW 一旦用户插入本指令，预处理程序将在使用new的地方插入DEBUG_NEW，而MFC作其余的工作。但用户编译自己的程序的一个发行版时，DEBUG_NEW便进行简单的new操作，而且不产生文件名和行号消息。

RUNTIME_CLASS

RUNTIME_CLASS(class_name)

说明：使用此宏从c++类中获取运行时类结构。RUNTIME_CLASS为由class_name指定的类返回一个指针到CRuntimeClass结构。只有以DECLARE_DYNAMIC,DECLARE_DYNCREATE或DECLARE_SERIAL定义的CObject派生类才返回到一个CRuntimeClass结构的指针。

DECLARE_DYNAMIC

DECLARE_DYNAMIC(class_name)

说明：但从CObject派生一个类时，此宏增加关于一个对象类的访问运行时功能。把DECLARE_DYNAMIC宏加入类的头文件中，然后在全部需要访问此类对象的.CPP文件中都包含此模块。如果像所描述那样使用DELCARE_DYNAMIC和IMPLEMENT_DYNAMIC 宏，那么用户便可使用RUNTIME_CLASS宏和CObject::IsKindOf函数以在运行时间决定对象类。如果DECLARE_DYNAMIC包含在类定义中，那么IMPLEMETN_DYNAMIC必须包含在类工具中。

IMPLEMENT_DYNAMIC

IMPLEMENT_DYNAMIC(class_name,base_class_name)

说明：通过运行时在串行结构中为动态CObject派生类访问类名和位置来产生必要的C++代码。在.CPP文件中使用IMPLEMENT_DYNAMIC宏，接着一次链接结果对象代码

DECLARE_DYNCREATE(class_name)

说明：使用DECLARE_DYNCRETE宏以便允许CObject派生类的对象在运行时刻自动建立。主机使用此功能自动建立新对象，例如，但它在串行化过程中从磁盘读一个对象时，文件及视图和框架窗应该支持动态建立，因为框架需要自动建立它。把DECLARE_DYNCREATE 宏加入类的.H文件中，然后在全部需要访问此类对象的.CPP文件中包含这一模式。如果DECLARE_DYNCREATE包含在类定义中，那么IMPLEMENT_DYNCREATE必须包含在类工具中。

IMPLEMENT_DYNCREATE

IMPLEMENT_DYNCREATE(class_name,base_class_name)

说明：通过DECLARE_DYNCREATE宏来使用IMPLEMENT_DYNCREATE宏，以允许CObject派生类对象在运行时自动建立。主机使用此功能自动建立对象，例如，但它在串行化过程中从磁盘读去一个对象时，他在类工具里加入IMPLEMENT_DYNCREATE宏。若用户使用DECLARE_DYNCREATE和IMPLEMENT_DYNCREATE宏,那么接着使用RUNTIME_CLASS宏和CObject::IsKindOf成员函数以在运行时确定对象类。若declare_dyncreate包含在定义中，那么IMPLEMENT_DYNCREATE必须包含在类工具中。DECLARE_SERIAL

DECLARE_SERIAL(class_name)

说明：DECLARE_SERIAL为一个可以串行化的CObject派生类产生必要的C++标题代码。串行化是把某个对象的内容从一个文件读出和写入一文件。在.H文件中使用DECLARE_SERIAL宏，接着在需要访问此类对象的全部.CPP文件中包含此文件。如果DECLARE_SERIAL包含在类定义中，那么IMPLEMENT_SERIAL必须包含在类工具中。DECLARE_SERIAL宏包含全部DECLARE_DYNAMIC,IMPLEMENT_DYCREATE的功能。IMPLEMENT_SERIAL

IMPLEMENT_SERIAL(class_name,base_class_name,wSchema)

说明：通过运行时在串行结构中动态CObject派生类访问类名和位置来建立必要的C++代码。在.CPP文件中使用IMPLEMENT_SERIAL宏，然后一次链接结果对象代码。

ON_COMMAND

ON_COMMAND(id,memberFxn)

说明：此宏通过ClassWizard或手工插入一个消息映射。它表明那个函数将从一个命令用户接口（例如一个菜单项或toolbar按钮）处理一个命令消息。当一个命令对象通过指定的ID 接受到一个Windows WM_COMMAND消息时，ON_COMMAND将调用成员函数memberFxn处理此消息。在用户的消息映射中，对于每个菜单或加速器命令（必须被映射到一个消息处理函数）应该确实有一个ON_COMMAND宏语句。

ON_CONTROL

ON_CONTROL(wNotifyCode,id,memberFxn)

说明：表明那个函数将处理一个常规控制表示消息。控制标识消息是那些从一个控制夫发送到母窗口的消息。

ON_MESSAGE

ON_MESSAGE(message,memberFxn)

说明：指明那个函数将处理一用户定义消息。用户定义消息通常定义在WM_USER到0x7FF 范围内。用户定义消息是那些不是标准Windows WM_MESSAGE消息的任何消息。在用户的消息映射中，每个必须被映射到一个消息处理函数。用户定义消息应该有一个ON_MESSAGE宏语句。

ON_REGISTERED_MESSAGE

ON_REGISTERED_MESSAGE(nmessageVarible,memberFxn)

说明：Windows的RegisterWindowsMesage函数用于定义一个新窗口消息，此消息保证在整个系统中是唯一的。此宏表明那个函数处理已注册消息。变量nMessageViable应以NEAR 修饰符来定义。

ON_UPDATE_COMMAND_UI

ON_UPDATE_COMMAND_UI(id，memberFxn)

说明：此宏通常通过ClassWizard被插入一个消息映射，以指明哪个函数将处理一个用户接口个更改命令消息。在用户的消息映射中，每个用户接口更改命令（比讯被映射到一个消息处理函数）应该有一个ON_UPDATE_COMMAND_UI宏语句。

ON_VBXEVENT

ON_VBXEVENT(wNotifyCode,memberFxn)

说明：此宏通常通过ClassWizard被插入一个消息映射，以指明该个函数将处理一个来自VBX控制的消息。在用户的消息映射中每个被映射到一消息处理函数的VBX控制消息应该有一个宏语句。

VC中的“\”用在编译预处理语句中，主要作用就是连接下一段的字符串，这个“\”的作用是提示编译器，后面还有字符，不过这些字符在下一行，如果删除，那么编译器就认为#define到此为止，那么下面的字符就要报错，而加上这个“\”，下面的字符就是加在#define 后面的符号中的，比如

#define CLASS class \

= new class

其实就是#define CLASS class = new class

另外说下预处理中还有“##”字符，这个字符的作用是连接字符串，比如class##Name 的意思就是className。