学习VC MFC开发必须了解的常用宏和指令

 

1、#include指令   
包含指定的文件   
 
2、#define指令    
预定义,通常用它来定义常量(包括无参量与带参量)，以及用来实现那些“表面似和善、背后一长串”的宏，它本身并不在编译过程中进行，而是在这之前(预处理过程)就已经完成了  
 
3、#typedef指令  
常用来定义一个标识符及关键字的别名它是语言编译过程的一部分，但它并不实际分配内存空间。  
 
4、#ifndef  #else   #endif指令   
条件编译。一般情况下，源程序中所有的行都参加编译。但是有时希望对其中一部分内容只在满足一定条件才进行编译，也就是对一部分内容指定编译的条件，这就是“条件编译”。有时，希望当满足某条件时对一组语句进行编译，而当条件不满足时则编译另一组语句。   
条件编译命令最常见的形式为：   
#ifdef  标识符   
  程序段1   
#else   
  程序段2    
#endif    
它的作用是：当标识符已经被定义过(一般是用#define命令定义)，则对程序段1进行编译，否则编译程序段2。  
 
5、#Pragma 指令   
在所有的预处理指令中，#Pragma 指令可能是最复杂的了，它的作用是设定编译器的状态或者是指示编译器完成一些特定的动作。其格式一般为   
#Pragma Para   
其中Para 为参数，下面来看一些常用的参数。  
l         message 参数。它能够在编译信息输出窗口中输出相应的信息，这对于源代码信息的控制是非常重要的。其使用方法为：   
#Pragma message(“消息文本”)   
当编译器遇到这条指令时就在编译输出窗口中将消息文本打印出来。   
当我们在程序中定义了许多宏来控制源代码版本的时候，我们自己有可能都会忘记有没有正确的设置这些宏，此时我们可以用这条指令在编译的时候就进行检查。假设我们希望判断自己有没有在源代码的什么地方定义了_X86这个宏可以用下面的方法  
 #ifdef  _X86  
        #Pragma message(“_X86 macro activated!”)  
        #endif     
当我们定义了_X86这个宏以后，应用程序在编译时就会在编译输出窗口里显示“_X86 macro activated!”。我们就不会因为不记得自己定义的一些特定的宏而抓耳挠腮了   
l         另一个使用得比较多的pragma参数是code_seg。格式如：  
 #pragma  code_seg ( ["section-name" [,"section-class" ] ] )   
它能够设置程序中函数代码存放的代码段，当我们开发驱动程序的时候就会使用到它。   
l         #pragma  once    
只要在头文件的最开始加入这条指令就能够保证头文件被编译一次，这条指令实际上在VC6中就已经有了，但是考虑到兼容性并没有太多的使用它。   
l         #pragma  hdrstop   
表示预编译头文件到此为止，后面的头文件不进行预编译。BCB可以预编译头文件以加快链接的速度，但如果所有头文件都进行预编译又可能占太多磁盘空间，所以使用这个选项排除一些头文件。有时单元之间有依赖关系，比如单元A依赖单元B，所以单元B要先于单元A编译。你可以用#pragma startup指定编译优先级，如果使用了#pragma package(smart_init) ，BCB就会根据优先级的大小先后编译。   
l         #pragma  resource "*.dfm"    
表示把*.dfm文件中的资源加入工程。*.dfm中包括窗体外观的定义。   
l         #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)。  
l         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的实现不同，在一个编译器中有效在别的编译器中几乎无效。可从编译器的文档中查看。  
 
6、宏：__LINE__  和__FILE__  
    定义源程序文件名和代码行，这对于调试跟踪代码错误行很有帮助。  
__TIME__          ：编译时间  
__DATE__      ：编译日期  
__TIMESTAMP__ ：文件修改时间  
 
7、调试宏：ASSERT()、VERIFY()、TRACE()  
这三个宏在Debug环境下特别有效，常用于代码的跟踪调试。它们是否起作用取决于是否定义了预定义了宏 _DEBUG  
l         ASSERT  
ASSERT(booleanExpression)  
说明：  
计算变量的值。如果结构的值为0，那么此宏便打印一个诊断消息并且程序运行失败。如果条件为非0，那么什么也不做。诊断消息的形式为： assertion failed in file in line 其中name是元文件名，num是源文件中运行失败的中断号。 在 Release版中，ASSERT不计算表达式的值也就不中断程序。如果必须计算此表达式的值且不管环境如何那么用VERIFY代替ASSERT。  
这个宏通常原来判断程序中是否出现了明显非法的数据，如果出现了终止程序以免导致严重后果，同时也便于查找错误。  
ASSERT_VAILD  
ASSERT_VAILD(pObject)  
说明：  
用于检测关于对象的内部状态的有效性。ASSERT_VALID调用此对象的AssertValid成员函数（把它们作为自己的变量来传递）。在 Release版中ASSERT_VALID什么也不做。在DEBUG版中，他检查指针，以不同于NULL的方式进行检查，并调用对象自己的 AssertValid成员函数。如果这些检测中有任何一个失败的话，那么他会以与ASSERT相同的方法显示一个警告的消息。  
l         VERIFY  
VERIFY(booleanExpression)  
说明：  
在MFC的DEBUG版中，VERIFY宏计算它的变量值。如果结果为0，那么宏打印一个诊断消息并中止程序。如果条件不为0，那么什么工作也不作。诊断有如下形式： assertion failed in file in line 其中name是源文件的名字，num是在源文件中失败的中止行号。在 MFC的Release版中，VERIFY计算表达式值但不打印或中止程序。例如：如果表达式是个函数调用，那么调用成功。  
l         TRACE  
TRACE(exp)  
说明：  
把一个格式化字符串送到转储设备，例如，文件或调试监视器，功能上和printf相似，可以说就是调试环境下printf的一个拷贝。TRACE宏是一个在程序运行时跟踪变量值的方便形式。在DEBUG环境中，TRACE宏输出到afxDump。在Release版中他不做任何工作。另外还有一组可以带参数的相似的宏：TRACE0、TRACE1、TRACE2和TRACE3。提供格式如：  
TRACE0(exp)  
TRACE1(exp,param1)  
TRACE2(exp,param1,param2)  
TRACE3(exp,param1,param2,param3)  
与TRACE相似，但它把跟踪字符串放在代码段中，而不是DGROUP，因此使用少的DGROUP空间。这些宏的用法和printf类似。  
 
8、消息处理宏：DECLARE_MESSAGE_MAP 、BEGIN_MESSAGE_MAP、END_MESSAGE_MAP  
DECLARE_MESSAGE_MAP()  
说明：  
用户程序中的每个CCmdTarget派生类必须提供消息映射以处理消息。在类定义的末尾使用DECLARE_MESSAGE_MAP宏。接着，在定义类成员函数的.CPP文件中，使用BEGIN_MESSAGE_MAP宏，每个用户消息处理函数的宏项下面的列表以及END_MESSAGE_MAP宏。  
注释：  
如果在DECLARE_MESSAGE_MAP之后定义任何一个成员，那么必须为他们指定一个新存取类型（公共的，私有的，保护的）。  
BEGIN_MESSAGE_MAP(the class ,baseclass)  
END_MESSAGE_MAP  
说明：  
使用BEGIN_MESSAGE_MAP开始用户消息映射的定义。在定义用户类函数的工具（.cpp）文件中，以BEGIN_MESSAGE_MAP宏开始消息映射，然后为每个消息处理函数增加宏项，接着以END_MESSAGE_MAP宏完成消息映射。  
 
9、消息映射宏：ON_COMMAND 、ON_CONTROL、ON_MESSAGE、ON_VBXEVENT、ON_Update_COMMAND_UI和ON_REGISTERED_MESSAGE  
ON_COMMAND(id,memberFxn)  
说明：  
此宏通过ClassWizard或手工插入一个消息映射。它表明那个函数将从一个命令用户接口（例如一个菜单项或toolbar按钮）处理一个命令消息。当一个命令对象通过指定的ID接受到一个Windows WM_COMMAND消息时，ON_COMMAND将调用成员函数memberFxn处理此消息。在用户的消息映射中，对于每个菜单或加速器命令（必须被映射到一个消息处理函数）应该确实有一个ON_COMMAND宏语句。  
ON_CONTROL(wNotifyCode,id,memberFxn)  
说明：  
表明哪个函数将处理一个常规控制表示消息。控制标识消息是那些从一个控制夫发送到母窗口的消息。  
ON_MESSAGE(message,memberFxn)  
说明：  
指明哪个函数将处理一用户定义消息。用户定义消息通常定义在WM_USER到0x7FF范围内。用户定义消息是那些不是标准 Windows WM_MESSAGE消息的任何消息。在用户的消息映射中，每个必须被映射到一个消息处理函数。用户定义消息应该有一个 ON_MESSAGE宏语句。  
ON_Update_COMMAND_UI(id，memberFxn)  
说明：  
此宏通常通过ClassWizard被插入一个消息映射，以指明哪个函数将处理一个用户接口个更改命令消息。在用户的消息映射中，每个用户接口更改命令（比讯被映射到一个消息处理函数）应该有一个ON_Update_COMMAND_UI宏语句。  
ON_VBXEVENT(wNotifyCode,memberFxn)  
说明：  
此宏通常通过ClassWizard被插入一个消息映射，以指明哪个函数将处理一个来自VBX控制的消息。在用户的消息映射中每个被映射到一消息处理函数的VBX控制消息应该有一个宏语句。  
ON_REGISTERED_MESSAGE(nmessageVarible,memberFxn)  
说明：  
Windows的RegisterWindowsMesage函数用于定义一个新窗口消息，此消息保证在整个系统中是唯一的。此宏表明哪个函数处理已注册消息。变量nMessageViable应以NEAR修饰符来定义。 
 
10、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操作，而且不产生文件名和行号消息。  
 
11、异常宏：TRY、CATCH 、THROW、AND_CATCH、THROW_LAST和END_CATCH  
TRY  
说明：  
使用此宏建立一TRY块。一个TRY识别一个可排除异常的代码块。这些异常在随后的CATCH和AND_CATCH块处理。传递是允许的：异常可以传递一个外部TRY块，或者忽略它们或者使用THROW_LAST宏。  
CATCH(exception_class,exception_object_pointer_name)  
说明：  
使用此用定义一个代码块，此代码用来获取当前TRY块中都一个异常类型。异常处理代码可以访问异常对象，如何合适的话，就会得到关于异常的特殊原因的更多消息。调用THROW_LAST宏以把处理过程一下一个外部异常框架，如果exception-class是类CExceptioon,那么会获取所有异常类型。用户可以使用CObject::IsKindOf成员函数以确定那个特别异常被排除。一种获取异常的最好方式是使用顺序的AND_CATCH语句，每个带一个不同的异常类型。此异常类型的指针由宏定义，用户不必定义。  
注释：  
此CATCH块被定义作一个C++范围（由花括号描述）。如用户在此范围定义变量，那么它们只在吃范围内可以访问。他还可以用于异常对象的指针名。  
THROW(exception_object_pointer)  
说明：  
派出指定的异常。THROW中断程序的运行，把控制传递给用户程序中的相关的CATCH块。如果用户没有提供CATCH块，那么控制被传递到一个MFC模块，他打印出一个错误并终止运行。  
AND_CATCH(exception_class,exception _object_point_name)  
说明：  
定义一个代码块，它用于获取废除当前TRY块中的附加异常类型。使用CATCH宏以获得一个异常类型，然后使用AND_CATCH宏获得随后的异常处理代码可以访问异常对象（若合适的话)已得到关于异常的特别原因的更多消息。在AND_CATCH块中调用THROW_LAST宏以便把处理过程移到下个外部异常框架。AND_CATCH可标记CATCH或AND_CATCH块的末尾。  
注释：  
AND_CATCH块被定义成为一个C++作用域（由花括号来描述）。若用户在此作用域定义变量，那么记住他们只在此作用域中可以访问。他也用于exception_object_pointer_name变量。  
THROW_LAST()  
说明：  
此宏允许用户派出一个局部建立的异常。如果用户试图排除一个刚发现的异常，那么一般此异常将溢出并被删除。使用THROW_LAST,此异常被直接传送到下一个CATCH处理程序。  
END_CATCH  
说明：  
标识最后的CATCH或AND_CATCH块的末尾。  
 
12、DECLARE_DYNAMIC 、IMPLEMENT_DYNAMIC  
DECLARE_DYNAMIC(class_name)  
说明：  
但从CObject派生一个类时，此宏增加关于一个对象类的访问运行时间功能。把DECLARE_DYNAMIC宏加入类的头文件中，然后在全部需要访问此类对象的.CPP文件中都包含此模块。如果像所描述那样使用DELCARE_DYNAMIC和IMPLEMENT_DYNAMIC宏，那么用户便可使用 RUNTIME_CLASS宏和CObject::IsKindOf函数以在运行时间决定对象类。如果DECLARE_DYNAMIC包含在类定义中，那么IMPLEMETN_DYNAMIC必须包含在类工具中。   
IMPLEMENT_DYNAMIC(class_name,base_class_name) 
说明：  
通过运行时在串行结构中为动态CObject派生类访问类名和位置来产生必要的C++代码。在.CPP文件中使用IMPLEMENT_DYNAMIC宏，接着一次链接结果对象代码  
 
13、DECLARE_DYNCreate、IMPLEMENT_DYNCreate   
DECLARE_DYNCreate(class_name)  
说明：  
使用DECLARE_DYNCRETE宏以便允许CObject派生类的对象在运行时刻自动建立。使用此功能自动建立新对象，例如，但它在串行化过程中从磁盘读一个对象时，文件及视图和框架窗应该支持动态建立，因为框架需要自动建立它。把DECLARE_DYNCreate宏加入类的.H文件中，然后在全部需要访问此类对象的.CPP文件中包含这一模式。如果DECLARE_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必须包含在类工具中。  
 
14、DECLARE_SERIAL、IMPLEMENT_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(class_name,base_class_name,wSchema)  
说明：  
通过运行时在串行结构中动态CObject派生类访问类名和位置来建立必要的C++代码。在.CPP文件中使用IMPLEMENT_SERIAL宏，然后一次链接结果对象代码。  
 
15、RUNTIME_CLASS  
RUNTIME_CLASS(class_name)  
说明：  
使用此宏从c++类名中获取运行时类结构。RUNTIME_CLASS为由class_name指定的类返回一个指针到CRuntimeClass结构。只有以DECLARE_DYNAMIC、DECLARE_DYNCreate或DECLARE_SERIAL定义的CObject派生类才返回到一个 CRuntimeClass结构的指针。

 

 

本文转载自：http://hi.baidu.com/walfer/blog/item/ba59bc356209d78ba71e123e.html